mcpField
C
claude-army

claude-army

本地服务
github.com/robbhimself-1337AI 与智能体134 周前更新
代码仓库

关于 claude-army

claude-army 是一个 MCP 服务，让 Claude 从聊天界面调度多个 Claude Code Agent，在不同项目目录中并行执行编码任务。它支持后台运行、进度与输出查看，以及由主 Agent 拆分任务的团队模式。

主要功能

  1. 01向项目目录派发编码任务
  2. 02并行运行多个 Agent
  3. 03查看任务状态与进度
  4. 04获取 Agent 输出和团队结构
  5. 05取消或清理任务

适用场景

  1. 01同时处理多个项目的编码工作
  2. 02后台运行较长时间的重构
  3. 03跟踪团队 Agent 的子任务进度

MCP 相关

它通过 MCP 向兼容客户端提供 Agent 派发、监控、输出检索和取消等工具；服务启动 Claude Code 后台进程执行任务。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "robbhimself-1337-claude-army": {
      "command": "npx",
      "args": [
        "-y",
        "claude-army"
      ]
    }
  }
}
启动命令npx -y claude-army

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmclaude-army0.3.1

工具

5

收录的工具列表 · 更新于 3 周前

参数类型必填说明
taskstring是为 Claude Code Agent 执行的任务提供清晰描述
modelstring否可选的模型覆盖值（例如 'opus'、'sonnet'）。默认为 Claude Code 配置的模型。
permission_modeenum否Agent 的权限模式。'acceptEdits' 会自动批准文件编辑。'bypassPermissions' 会跳过所有检查（请谨慎使用）。default | acceptEdits | plan | bypassPermissions
working_directorystring是项目目录的绝对路径（例如 /home/robbhimself/GarbageFire）

详细介绍

🪖 ClaudeArmy

Version License Node

一个 MCP 服务，可让 Claude 协调多个 Claude Code Agent，在不同项目中自主工作。

ClaudeArmy 演示

功能介绍

ClaudeArmy 让 Claude（聊天界面中的 Claude）能够启动在后台独立处理编码任务的 Claude Code 进程。可以将它看作一条指挥链：

  • 你 → 提供战略方向
  • Claude（聊天） → 拆解任务并派遣 Agent
  • Claude Code Agent → 自主执行，并根据需要启动自己的子 Agent

这意味着你可以同时在多个项目中开展工作，照常聊天，并随时查看进度。

工具

工具描述
dispatch_task在项目目录中启动 Claude Code Agent。支持 mode: "team"，用于多 Agent 协作
check_tasks监控所有运行中或已完成 Agent 的状态
get_task_output获取 Agent 的工作内容及完整输出
get_agent_team查看主 Agent 及其所有子 Agent 的详细信息
cancel_task平稳停止正在运行的 Agent
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
    • Windows： %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. 重启 Claude Desktop

使用示例

单个项目任务：

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

多个项目并行处理：

“将 GarbageFire 重构得更模块化，并为我的 Reporting Tool 添加 Salesforce 适配器”

Claude 会向各个项目目录分别派遣 Agent，让它们自主工作。

查看进度：

“Agent 们进展如何？”

Agent 团队

在 dispatch_task 中使用 mode: "team"，让主 Agent 自动拆解工作，并启动并行运行的专用子 Agent。

工作方式：

  • 主 Agent 分析任务，并将其拆分为重点明确的子任务
  • 通过 Claude Code 的 Task 工具将每个子任务交给一个子 Agent
  • 子 Agent 并行工作，各自负责明确的范围
  • 所有子 Agent 完成后，主 Agent 汇总结果

监控团队：

  • check_tasks 会显示子 Agent 概览（例如：“3 个子 Agent：1 个运行中，2 个已完成”）
  • get_agent_team 会以详细的树状视图展示主 Agent 及每个子 Agent，包括状态、运行时间和输出预览

配置

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

  • CLAUDE_BINARY - Claude Code 可执行文件的路径
  • MAX_CONCURRENT_TASKS - 同时运行的 Agent 数量上限（默认为 5）

要求

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

更新日志

v0.4.1
  • 将 @modelcontextprotocol/sdk 升级至 ^1.26.0，修复 3 个高危供应链漏洞
  • 在 package.json 中添加 repository 字段
v0.4.0
  • 支持 Agent 团队：跟踪通过 Claude Code Task 工具启动的子 Agent
  • 新增 get_agent_team 工具：以树状视图展示主 Agent 及所有子 Agent
  • check_tasks 现在会显示团队任务的子 Agent 概览
  • dispatch_task 新增 mode 参数：solo（默认）或 team
  • 跨平台支持：修复 Windows 可执行文件（claude.cmd）和信号处理
  • 错误消息现在会显示适用于相应平台的诊断命令
  • README：添加 Linux、macOS 和 Windows 的设置路径
v0.3.0
  • 修复 stream-json 解析，正确处理助手消息内容数组
  • 过时状态指示器：check_tasks 现在会显示距离 Agent 上次活动的时间
  • 改进错误提示：针对找不到 CLI、权限被拒绝和运行中途失败的情况提供可操作的提示
  • 修复 get_task_output 中的输出重复问题
  • README 中新增演示 GIF
v0.2.0
  • 通过 Claude Code 的 stream-json 输出实时跟踪进度
  • check_tasks 现在会显示近期 Agent 活动（读取文件、编辑文件、执行 bash 命令），而不只是运行时间
  • get_task_output 包含带时间戳的完整进度时间线
  • 对工具使用、助手消息和结果进行结构化事件解析
v0.1.0
  • 首次发布
  • 核心工具：dispatch_task、check_tasks、get_task_output、cancel_task、purge_tasks
  • 即发即忘架构，并通过后台进程进行管理
  • 最多支持 5 个并发 Agent
  • MCP 通信使用 stdio 传输

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。