Bugsy MCP 服务器实现
使用说明（Markdown 格式）
- 项目简介
- Bugsy 的 MCP 服务器实现提供了标准化的后端服务，用于向 MCP 客户端（如 LLM 客户端）提供上下文信息和功能，包括资源管理、工具注册及调用、以及 Prompt 的定义与渲染，使用 JSON-RPC 协议进行请求/响应通信。
- 主要功能点
- 资源管理与数据访问：托管、查询和管理可用的 Resources（资源）以供 LLM 客户端使用。
- 工具注册与执行：注册外部工具，并在 MCP 客户端请求时执行对应任务。
- Prompt 模板定义与渲染：定义与渲染可定制的 Prompt 模板，支持不同的交互模式与输出形式。
- JSON-RPC 通信：通过标准的 JSON-RPC 请求/响应模型处理工具调用、资源读取、Prompts 获取等请求。
- 会话与能力声明：服务器端管理会话、能力（即可用的资源、工具、Prompt) 的声明。
- 多传输协议支持：在需要时可通过 Stdio、SSE、WebSocket 等传输协议与前端/LLM 客户端通信，确保在受限网络环境中的可用性。
- 安全与可扩展性：对输入参数进行校验、提供路径验证等安全机制，便于在多种部署环境中扩展。
- 安装步骤
- 按照项目提供的 README 指引，在合适的运行环境中安装依赖并构建服务器。推荐在 Node.js 环境中使用 npm/yarn/pnpm 进行安装与构建。
- 通过命令行启动 MCP 服务器（示例命令见下方配置示例）：
- npx mobbdev mcp
- 服务器配置（MCP 客户端使用的配置示例，需提供 server 启动命令与参数）
- JSON 配置要点：
- server 名称：mobb-mcp
- 启动命令：npx
- 参数：["mobbdev","mcp"]
- 环境变量（可选，用于身份认证与控制行为）：
- API_KEY: 您的 Mobb API 密钥
- API_URL: MCP 服务端地址（https 默认值为 https://app.mobb.ai）
- MVS_AUTO_FIX: 是否启用自动修复的开关，"true" 或 "false"
- JSON 表达示例（描述性说明，不作为代码片段直接粘贴使用）：
- serverName: mobb-mcp
- command: npx
- args: ["mobbdev","mcp"]
- env: API_KEY=your_mobb_api_key_here, API_URL=https://app.mobb.ai, MVS_AUTO_FIX=true
- 注：MCP 客户端需要的配置仅用于连接 MCP 服务器，实际调用细节在客户端代码中处理，服务器端提供对等的接口以供客户端对接。
- JSON 配置要点：
- 基本使用方法
- 连接与交互
- 客户端通过 JSON-RPC 调用 MCP 服务器提供的接口，如 list_tools、call_tool、list_prompts、get_prompt 等，获取工具、资源、Prompt 的信息并执行对应操作。
- 典型工作流
- 客户端查询可用工具，调用某个工具执行某项任务，获取或渲染对应的结果（如代码修复建议、Prompts 输出等）。
- 客户端请求 Prompts、获取输出内容，然后将输出作为上下文或指令输入给 LLM。
- 调试与日志
- MCP 服务器端会输出调试日志，帮助排错；在生产环境中可通过日志配置过滤敏感信息。
- 连接与交互