使用说明

• 项目简介

  • 本项目实现了一个基于 MCP（Model Context Protocol）的服务器端，专注于为 LLM 客户端提供结构化的上下文服务，包括资源与工具的管理、Prompt 渲染、以及多智能体协作能力。服务器通过 JSON-RPC 接口接收客户端请求（如获取工具、执行工具、获取提示模板等），并返回标准化的 JSON-RPC 响应或通知。

• 主要功能点

  • MCP 核心能力：注册并暴露工具集合（如 team_work、ask_expert、read_project_files 等），通过 ListTools 与 CallTool 请求进行交互。
  • 动态专家与编排：通过 Tech Lead、Orchestrator、History、Workflow 等组件实现动态专家创建、任务分解、并发/顺序/混合工作流执行，以及历史记录保存。
  • 会话与历史：提供历史记录管理、任务上下文、执行日志、以及可检索的历史条目与摘要。
  • 支持的传输：实现以 Stdio 传输为主的 MCP 通信，便于在本地进程间直接通信；设计上也具备对其他传输方式的扩展潜力。
  • 配置与扩展性：通过配置系统加载模型、模型池、工作流模板及自定义专家等，支持热重载与自定义模板。

• 安装步骤

  • 安装 Node.js 18+ 及相关运行环境。
  • 克隆仓库并安装依赖（如存在 package.json，执行 npm install；若为纯 TS 项目，需执行对应的构建步骤）。
  • 构建产物（如有构建脚本，执行构建，将 TS 编译为 JS，如 tsc 生成 dist/）。
  • 启动 MCP 服务器（后续客户端通过 MCP 协议对接）：
    • 推荐方式：将编译产物 dist/index.js（或实际入口文件）作为入口启动，例如 node dist/index.js。
    • 也可通过现有 CLI 启动（若提供 claude-team serve 命令），以集成的方式启动 MCP 服务。

• 服务器配置（MCP 客户端需要的连接信息）

  • server 名称：claude-team
  • command: node
  • args: ["dist/index.js"] 备注：上述为示例，具体入口路径取决于实际构建产物的位置与文件名。若使用直接运行 TypeScript 的环境，请以实际入口（如 src/index.ts）对应的执行方式为准。
  • 说明：MCP 客户端配置应包含 server 名称、启动命令与参数，便于通过客户端以标准化方式连接到 MCP 服务器并发起 ListTools、CallTool 等请求。

• 基本使用方法

  • 启动服务器后，使用 MCP 客户端向服务器发起 JSON-RPC 请求：
    • 请求 ListTools，获取可用工具及其输入输出定义。
    • 使用 CallTool 触发具体工具，如 team_work、history_list、read_project_files 等，传入相应参数。
  • 客户端与服务器之间遵循 JSON-RPC 约定，响应中包含相应的结果数据或错误信息。
  • 如需扩展功能，可在服务端添加新的工具、工作流模板以及自定义专家配置，并通过相应的 ListTools/CallTool 实现暴露。

• 额外信息

  • MCP 服务端在本实现中通过 StdioServerTransport 与客户端通信，便于本地开发和调试场景。
  • 服务器实现了多种辅助能力（如历史、策略、统计、模板等），便于在实际对话与协作场景中进行追踪、分析与可观测性检查。