使用说明(Markdown 形式)
-
项目简介 Claude Swarm 是一个基于 MCP 的后端服务器,负责管理会话、资源、工具、协议与提示模板,提供可扩展的上下文服务,供 LLM 客户端调用与交互。
-
主要功能点
- 资源与数据访问:托管与管理“资源/数据”,方便 LLM 客户端读取与写入所需信息。
- 工具注册/执行:注册可用工具,LLM 客户端可通过工具调用实现外部功能访问。
- 提示模板(Prompts)渲染:定义与渲染与特定任务相关的提示模板以引导对话。
- MCP 协议治理:注册、激活与执行行为约束,支持基础约束、基于协议的监控与审计。
- 会话与状态管理:持久化会话状态,支持持久化、恢复、检查进度与日志。
- Dashboard 与监控:Web UI(SSE)实时展示状态,实时输出流式查看 Worker。
- 多传输协议:支持例如 Stdio、SSE、WebSocket(代码中实现了 Stdio 传输与 SSE 监控)。
-
安装步骤
- 克隆仓库并进入项目目录
- 安装依赖并构建
- npm install
- npm run build
- 启动 MCP 服务器(示例命令,实际请按下列“服务器配置”中的参数执行) node dist/index.js
- 如需仪表盘,确保环境变量 DASHBOARD_PORT=3456(默认 3456)并启用仪表盘
- 将服务器注册到 Claude Code/客户端,例如通过 claude mcp add claude-swarm --scope user -- node dist/index.js
-
服务器配置 MCP 客户端连接服务器时需提供配置(JSON),用于指示服务器的启动命令与参数等。以下为基于仓库信息的准确示例(仅描述,不包含代码块):
- serverName: claude-swarm
- command: node
- args: ["dist/index.js"]
- transport: stdio
- dashboard: enable 与端口配置,例如开启仪表盘并设置端口 3456
说明:MCP 客户端需要该配置信息来启动与 MCP 服务器建立连接,服务器端实现提供了基于 MCP 的工具、协议、资源等能力。以上字段为客户端连接所需的启动信息,具体可用的传输与配置项以客户端实现文档为准。
-
基本使用方法
- 初始化会话(orchestrator_init)并描述任务
- 启动一个或多个特征的工作分支(start_worker / start_parallel_workers)
- 实时查看状态(orchestrator_status / check_all_workers / get_progress_log / get_session_stats)
- 通过 mark_complete、retry_feature、pause/resume 等工具管理生命周期
- 完成后触发后续评审(run_review / check_reviews / get_review_results)
-
关键词 模型上下文、并行工作、协议治理、资源管理、监控
-
分类 6
-
备注 本实现尽量覆盖 MCP 的核心能力与后端服务功能,支持资源、工具、提示、协议治理以及会话管理等关键能力,并提供 dashboard 监控与跨实例协作能力,属于可运行的 MCP 服务器实现。若对客户端接入、传输协议或具体 API 细节有进一步需求,可参考仓库中的工具、协议及治理模块的实现。
信息
分类
AI与计算