使用说明（Markdown 格式）

• 项目简介

  • 该仓库实现了一个基于 MCP 的服务器端，能够接收来自 MCP 客户端的请求，执行分析、匹配、生成配置等智能工具，提供资源与标准（Prompts）的读取与渲染，并通过标准的 JSON-RPC 接口与客户端通信。
  • 服务器核心包含：工具处理、资源处理、错误处理、健康检查、标准资源管理、以及与 GitHub/本地代理的 Agent 管理能力。

• 主要功能点

  • 工具（Tools）管理与执行：analyze_project、auto_setup、health_check、get_smart_standards、use_preset、list_presets、match_agents、list_available_agents、generate_config、get_relevant_standards、get_standards_stats 等工具的注册与分发。
  • 资源（Resources）管理：读取和列出编码规范/标准资源，支持按 URI 读取标准内容。
  • Prompts 与 规范渲染：对标准资源进行组合渲染，生成项目特定的 Copilot 指令/配置。
  • 跨平台传输与会话：通过 StdioServerTransport 实现 MCP 的跨进程传输，理论上支持其它传输（如 SSE、WebSocket 等）。
  • 会话管理与健康诊断：健康检查、错误处理、日志记录、以及对服务器状态的健康诊断与建议。

• 安装步骤

  1. 安装依赖
     • 进入 mcp-server 目录后执行安装依赖命令（如 npm install）。
  2. 构建服务器
     • 运行 npm run build 将 TypeScript 代码编译为可执行的 build 目录。
  3. 启动服务器
     • 使用 Node 运行生成的入口文件，例如 node build/index.js。
     • 服务器启动后即可接收 MCP 客户端的请求（工具调用、资源读取等）。

• 服务器配置（供 MCP 客户端使用的连接信息，JSON 格式） 说明：MCP 客户端需要通过该配置连接到 MCP 服务器的启动命令与参数，以建立连接并进行请求。 配置示例（请替换为实际路径）： { "name": "copilot-prompts", "command": "node", "args": ["/绝对路径/copilot-prompts/mcp-server/build/index.js"], "autoStart": true } 注释说明：

  • name：服务器的唯一标识名称，便于客户端区分。
  • command：启动服务器的命令，本文实现中为 node。
  • args：服务器入口脚本的位置，需指向编译后的构建产物 index.js 的实际路径。
  • autoStart：是否自动启动（若客户端支持自动化管理，可设为 true）。

• 基本使用方法

  • 启动与连接
    • 启动 MCP 服务器后，MCP 客户端（如 Claude Desktop、VS Code Copilot Chat 等）按照上述配置中的 name、command、args 进行连接。
  • 常用操作
    • 通过工具（analyze_project、generate_config 等）分析项目特征，获取并应用相应的编码规范与 Agents。
    • 通过资源（list_resources、read_resource）获取并查看可用的规范资源，按需渲染成 Copilot 指令。
    • 使用 get_relevant_standards/get_standards_stats 等工具查询相关标准和性能指标。
  • 注意
    • MCP 客户端需要的只是服务器的启动命令和参数，服务器端的 JSON-RPC 端点会按 MCP 规格处理请求并返回结果。