使用说明(Markdown 形式)

  • 项目简介 Claude Swarm 是一个基于 MCP 的后端服务器,负责管理会话、资源、工具、协议与提示模板,提供可扩展的上下文服务,供 LLM 客户端调用与交互。

  • 主要功能点

    • 资源与数据访问:托管与管理“资源/数据”,方便 LLM 客户端读取与写入所需信息。
    • 工具注册/执行:注册可用工具,LLM 客户端可通过工具调用实现外部功能访问。
    • 提示模板(Prompts)渲染:定义与渲染与特定任务相关的提示模板以引导对话。
    • MCP 协议治理:注册、激活与执行行为约束,支持基础约束、基于协议的监控与审计。
    • 会话与状态管理:持久化会话状态,支持持久化、恢复、检查进度与日志。
    • Dashboard 与监控:Web UI(SSE)实时展示状态,实时输出流式查看 Worker。
    • 多传输协议:支持例如 Stdio、SSE、WebSocket(代码中实现了 Stdio 传输与 SSE 监控)。
  • 安装步骤

    1. 克隆仓库并进入项目目录
    2. 安装依赖并构建
      • npm install
      • npm run build
    3. 启动 MCP 服务器(示例命令,实际请按下列“服务器配置”中的参数执行) node dist/index.js
    4. 如需仪表盘,确保环境变量 DASHBOARD_PORT=3456(默认 3456)并启用仪表盘
    5. 将服务器注册到 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 的工具、协议、资源等能力。以上字段为客户端连接所需的启动信息,具体可用的传输与配置项以客户端实现文档为准。

  • 基本使用方法

    1. 初始化会话(orchestrator_init)并描述任务
    2. 启动一个或多个特征的工作分支(start_worker / start_parallel_workers)
    3. 实时查看状态(orchestrator_status / check_all_workers / get_progress_log / get_session_stats)
    4. 通过 mark_complete、retry_feature、pause/resume 等工具管理生命周期
    5. 完成后触发后续评审(run_review / check_reviews / get_review_results)
  • 关键词 模型上下文、并行工作、协议治理、资源管理、监控

  • 分类 6

  • 备注 本实现尽量覆盖 MCP 的核心能力与后端服务功能,支持资源、工具、提示、协议治理以及会话管理等关键能力,并提供 dashboard 监控与跨实例协作能力,属于可运行的 MCP 服务器实现。若对客户端接入、传输协议或具体 API 细节有进一步需求,可参考仓库中的工具、协议及治理模块的实现。

信息

分类

AI与计算