使用说明（Markdown格式）

• 项目简介 Code Guardian MCP Server 是一个面向 Claude Code 的后端 MCP 服务器实现。它以 MCP 协议为基础，通过 JSON-RPC 提供资源读取、工具执行、Prompt 模板获取等能力，供 LLM 客户端获取上下文信息与外部功能调用能力。服务器内置会话管理、能力声明及对接多种传输协议（如 StdIo、SSE、WebSocket）的能力扩展点，确保前后端在统一协议下高效交互。

• 主要功能点

  • 资源、工具、提示模板的托管与管理，向客户端暴露统一的读取、执行和渲染能力。
  • 注册与执行 Tools，LLM 客户端可通过 MCP 请求调用外部功能。
  • Prompt 模板的定义与渲染，支持可定制的 LLM 交互模式。
  • 会话管理与能力声明，支持持久化、跨会话上下文复用。
  • 支持多种传输协议扩展点，便于未来接入 SSE/WebSocket 等传输通道。
  • 安全、可扩展的上下文服务框架，便于对大语言模型任务进行上下文注入和功能扩展。

• 安装步骤

  1. 确认环境：Node.js 版本建议为较新的 LTS 版本。
  2. 获取源码并安装依赖：如 npm install。
  3. 构建/编译（如使用 TypeScript）：执行构建命令将源码编译为可执行 JS（例如输出到 dist/）。
  4. 启动服务器：在可控环境中执行启动命令，服务器将通过 MCP 的 StdIo 传输与客户端通信。
  5. 连接测试：使用 MCP 客户端建立连接，向服务器发起 JSON-RPC 请求，例如读取资源、执行工具、获取 Prompt 等。
  6. 参考文档与示例：结合仓库中的文档与示例验证各能力端点。

• 服务器配置（给 MCP 客户端的配置示例） 说明：MCP 客户端需要知道如何启动 MCP 服务器以建立通信。以下为配置示例字段说明，实际请按客户端文档或集成约定使用。该配置描述仅用于说明，不包含源码实现。

  { "serverName": "code-guardian", "command": "node", "args": ["dist/index.js"], "transport": "stdio", "description": "Code Guardian MCP 服务器，基于 JSON-RPC 的上下文与工具服务", "notes": "dist/index.js 为编译后的入口文件路径，实际路径以构建产物为准；StdIo 传输用于 MCP 基本通讯，后续可扩展为 SSE/WebSocket 等" }

• 基本使用方法

  • 启动与连接：通过上述配置启动 MCP 服务器后，MCP 客户端通过标准输入/输出（StdIo）与服务器进行 JSON-RPC 通信。
  • 常用能力：通过 JSON-RPC 请求读取 Resources、注册与调用 Tools、获取 Prompts 等，以实现 LLM 的上下文管理与外部功能调用。
  • 会话与能力：客户端可查询服务器能力声明、创建和管理会话，服务器负责会话状态的跨轮对话持久化与上下文提供。
  • 安全与扩展：在需要时可接入更多传输协议（如 SSE、WebSocket），并通过权限与能力控制实现对敏感能力的保护。

• 备注

  • 服务器实现以 MCP 协议为核心，提供标准化的资源、工具、Prompt 渲染与会话能力，具备可运行的服务器端逻辑，而非仅仅示例或客户端实现。
  • 如需将该服务器部署在生产环境，建议结合文档对接前端/LLM 客户端，确保 MCP 请求与响应的 JSON-RPC 格式与协议版本严格匹配。