Claude Code MCP 异步服务器

用于 Claude Code CLI 的异步 MCP 包装器

允许 Claude Code 启动子 Claude Code 会话以进行并行任务执行。

功能

• ✅ 异步执行 - 在后台启动任务，继续工作
• ✅ 多实例并行 - 同时运行多个 Claude Code 会话
• ✅ 自动清理 - 没有僵尸进程
• ✅ 零配置 - 开箱即用

快速开始

🚀 使用 UVX 安装

无需配置 - 直接运行：

uvx claudecode-mcp-async

配置 Claude Code

在你的 ~/.claude/settings.json 中添加：

{
  "mcpServers": {
    "claude-code-mcp": {
      "command": "uvx",
      "args": ["claudecode-mcp-async"],
      "env": {}
    }
  }
}

重启 Claude Code

重新加载或重启 Claude Code 以加载 MCP 服务器。

使用示例

🚀 异步执行（游戏规则改变者！）

启动一个长时间的任务，并立即继续工作：

你：

请分析整个项目的代码并生成一份全面的技术报告

Claude： 我将分析你的整个项目并生成一份技术报告。这是一个大型任务，所以我将异步启动它...

✅ 任务已启动（任务ID：abc12345） 你可以继续做其他事情，同时它在后台运行！

你：（立即继续工作）

当报告生成时，请帮我写一些单元测试

Claude： 当然！让我为你编写这些单元测试...

你：（几分钟后）

你能检查一下报告任务是否完成吗？

Claude： ✅ 报告已完成！

[查看详细技术报告]

• 项目结构分析
• 代码质量评估
• 性能优化建议
• 安全审计结果

⚡ 并行执行

同时运行多个任务：

你：

我需要同时做三件事：

1. 为 utils.py 生成单元测试
2. 将 database.py 改造为使用 async/await
3. 为 api.py 中的所有函数添加类型提示

Claude： 我将同时启动所有三个任务！

🔄 任务1已启动（任务ID：task1） - 生成单元测试 🔄 任务2已启动（任务ID：task2） - 重构数据库代码 🔄 任务3已启动（任务ID：task3） - 添加类型提示

所有任务都在并行运行...

你：（稍后）

这三个任务都完成了吗？

Claude： ✅ 全部完成！

• ✅ 任务1：utils.py 的单元测试已生成
• ✅ 任务2：database.py 已改造为异步模式
• ✅ 任务3：api.py 函数的类型提示已添加

🎯 快速同步任务

对于简单的即时任务：

你：

编写一个 Python 函数来验证电子邮件地址

Claude：

import re

def validate_email(email):
    pattern = r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$'
    return re.match(pattern, email) is not None

# 使用示例
print(validate_email("user@example.com"))  # True
print(validate_email("invalid-email"))    # False

✅ 任务已完成！

为什么是异步？

问题： Claude Code 在运行时会阻塞父会话。

解决方案： 此 MCP 服务器会启动在后台运行的子 Claude Code 进程。

优点：

• 🚀 启动任务并立即继续工作
• ⚡ 并行运行多个任务
• 🎯 不阻塞，不等待
• 🧹 自动进程清理

故障排除

服务器未显示？

• 在配置中使用绝对路径
• 运行：chmod +x claudecode_mcp_async_server.py
• 重启 Claude Code

任务卡在“运行”状态？

• 等一会儿，大型任务需要时间
• 检查：ls -la /tmp/claude_code_tasks/
• 查看日志：tail -f /tmp/claude_code_mcp_debug.log

要求

• Python 3.6+
• 已安装 Claude Code CLI

许可证

MIT 许可证

---

有问题？ 在 GitHub 上打开一个 Issue。