多Claude代理协同编程服务器

ClaudeArmy是一个MCP服务器,允许Claude协调多个Claude Code代理在不同项目中自主工作,实现多任务并行处理和团队协作编程。

  • by robbhimself-1337
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 robbhimself-1337/claude-army

使用说明

🪖 克劳德军队

一个MCP服务器,允许Claude编排多个在不同项目中自主工作的Claude Code代理。

它的作用

ClaudeArm使Claude(在聊天界面中)能够生成独立处理编码任务的后台Claude Code进程。把它想象成一个指挥链:

  • 你 → 提供战略方向
  • 克劳德(ChAT) → 将其分解并派遣特工
  • 克劳德代码代理 → 自主执行,根据需要生成自己的子代理

这意味着您可以同时启动多个项目的工作,保持正常聊天,并随时查看进度。

工具

工具 说明
dispatch_task 将Claude Code代理部署到项目目录。支持 mode: "team" 用于多智能体协调
check_tasks 监控所有正在运行/已完成的代理的状态
get_task_output 检索代理的操作及其完整输出
get_agent_team 主代理及其所有子代理的详细视图
cancel_task 优雅地停止正在运行的代理
purge_tasks 清理已完成/失败的任务

设置

  1. 克隆此仓库

  2. npm install

  3. 添加到您的Claude Desktop配置中:

    • Linux: ~/.config/Claude/claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户: %APPDATA%\Claude\claude_desktop_config.json
"claude-army": {
  "command": "node",
  "args": ["/path/to/claude-army/src/index.js"]
}

Windows注意事项: 在路径值中使用正斜杠(例如。 "C:/Users/you/claude-army/src/index.js").

  1. 重新启动克劳德桌面

用法示例

单个项目任务:

“将GarbageFire的app.py重构为模块化组件”

多项目并行工作:

“重构GarbageFire使其更加模块化,并在我的报告工具中添加Salesforce适配器”

Claude将向每个项目目录派遣单独的代理,让他们自主工作。

检查进度:

“特工们怎么样了?”

代理团队

使用 mode: "team" 上 dispatch_task 让主代理自动分解工作并生成并行运行的专用子代理。

它是如何工作的:

  • 首席代理分析任务并将其分解为重点子任务
  • 每个子任务都通过Claude Code委托给一个子代理 Task 工具
  • 子代理并行工作,每个子代理都有明确的范围
  • 所有子代理完成后,主代理将合成结果

监测小组:

  • check_tasks 显示子代理摘要(例如“3个子代理:1个正在运行,2个已完成”)
  • get_agent_team 提供主代理和每个子代理的详细树视图,包括状态、运行时和输出预览

配置

编辑顶部的常量 src/index.js:

  • CLAUDE_BINARY -克劳德代码二进制文件的路径
  • MAX_CONCURRENT_TASKS -最大并发代理数(默认值:5)

需求

  • Claude Code已安装并通过身份验证
  • Node.js 18+
  • Claude Desktop或任何兼容MCP的客户端

更新日志

v0.4.1

  • 碰撞 @modelcontextprotocol/sdk 升级到^1.26.0,解决了3个严重的供应链漏洞
  • 添加 repository 字段到package.json

v0.4.0

  • 代理团队支持:跟踪通过Claude Code Task工具生成的子代理
  • 新 get_agent_team 工具:潜在客户树视图+所有子代理
  • check_tasks 现在显示团队操作的子代理摘要
  • dispatch_task 收益 mode 参数: solo (默认)或 team
  • 跨平台:固定Windows二进制文件(claude.cmd)信号处理
  • 错误消息现在显示适用于平台的诊断命令
  • README:添加了Linux、macOS和Windows的安装路径

v0.3.0

  • 修复了流json解析以正确处理助理消息内容数组的问题
  • 稳定性指示器: check_tasks 现在显示自上次代理活动以来的时间
  • 更好的错误显示:未找到CLI的可操作消息、权限被拒绝和运行中失败
  • 修复了中的输出重复 get_task_output
  • 演示GIF已添加到README中

v0.2.0版本

  • 通过Claude Code的流json输出实时跟踪进度
  • check_tasks 现在显示最近的代理活动(文件读取、编辑、bash命令),而不仅仅是运行时
  • get_task_output 包括带有时间戳的完整进度时间表
  • 用于工具使用、辅助消息和结果的结构化事件解析

v0.1.0

  • 初始版本
  • 核心工具:调度任务、检查任务、获取任务输出、取消任务、清除任务
  • 即发即弃架构,具有后台流程管理
  • 最多5个并发代理
  • MCP通信的stdio传输

许可证

麻省理工学院