MAXSIM MCP 服务端

使用说明（Markdown格式）：

• 项目简介
  • 本项目实现了一个 MCP 服务器，用来向 LLM 客户端（如 Claude Code）提供统一的上下文服务，包括资源管理、工具注册以及提示模板等能力，通信通过 MCP 的 JSON-RPC 协议，默认通过标准输入输出进行传输。
• 主要功能点
  • MCP 核心能力：通过 MCP Server 接口暴露多个工具，包括阶段操作、状态管理、里程碑与路线图分析、 Artefakte 管理、前置条件与阶段上下文加载等。
  • 资源与工具注册：内置工具集合覆盖阶段、状态、路地图、代码库上下文等，支持对外进行数据读取、修改和执行任务的能力。
  • 上下文管理与渲染：提供 Context 加载、代码库文档选择等功能，方便 LLM 在对话中获得必要的外部信息。
  • 会话与能力声明：服务器实现了会话管理与能力声明，能够与客户端协商传输模式及能力边界。
  • 传输方式：当前实现以 stdio 传输为 MCP 服务器的运行时通信通道（ Claude Code 通过管道与 MCP 服务交互）。未来可扩展到 SSE/WebSocket。
• 安装步骤
  • 在本地获取代码并安装依赖（Node.js 环境）。安装完成后即可启动 MCP 服务器。
  • 运行方式示例（在可执行环境中，具体路径请按实际部署结构调整）：
    • node packages/cli/dist/mcp-server.js
  • 如需在 Claude Code 中使用，请将 MCP 服务器作为一个外部服务接入，参照下方的配置示例进行连接。
• 服务器配置（MCP 客户端的配置信息，JSON 格式，包含 server name、command、args 等）
  • 服务器名称与入口 { "name": "maxsim", "command": "node", "args": ["/path/to/your/project/packages/cli/dist/mcp-server.js"], "transport": "stdio" } 注释说明：
  • name：MCP 服务器在客户端环境中的名称，便于区分与日志追踪。
  • command：启动 MCP 服务器所需的执行命令，通常为 node。
  • args：MCP 服务器的入口脚本路径，指向 dist/mcp-server.js（实际部署中请替换为你环境中的正确路径）。
  • transport：通信传输方式，此处设为 stdio（通过标准输入输出进行 JSON-RPC 通信）。若后续扩展为 SSE/WebSocket，可在此字段调整并提供相应传输参数。
• 基本使用方法
  • 启动后，Claude Code 将通过 MCP 客户端连接该服务器，客户端可以调用暴露的工具集完成阶段、状态、代码上下文等操作。
  • 客户端通过 MCP 的 JSON-RPC 请求来读取资源、执行工具、获取 Prompt 模板等，服务器返回 JSON-RPC 响应。
  • 服务器负责维护会话、能力声明以及对传输通道的正确响应。
• 备注
  • 仓库内包含完整的 MCP 服务端实现以及对外暴露的工具集合，代码基于 @modelcontextprotocol/sdk 的 MCP 服务端实现，结合 Claude Code 的 MCP 客户端进行对接。