XStream MCP 服务端

使用说明（Markdown 格式）

• 项目简介
  • 该仓库实现了一个可运行的 MCP 服务器，核心通过 Mark3 MCP 库提供 JSON-RPC 风格的接口，允许客户端查询工作区信息、注册并执行工具、以及获取/渲染提示模板等能力。服务器通过标准的 Go 语言实现，具备多平台部署能力（Linux、Windows、macOS、Android、iOS 等前端桥接实现）。实际启动与通信通过标准输入输出（STDIO）或其他传输通道完成。
• 主要功能点
  • 注册并暴露工具（Tools）：提供一组 MCP 工具（如工作区信息、系统诊断、运行时检查、身份认证等），客户端可调用并获得结构化的 JSON 结果。
  • 提供并管理资源与数据访问能力（Resources）及提示模板（Prompts）的后端支持，用于向 LLM 客户端提供上下文信息。
  • 会话管理与能力声明：服务器维护会话状态和能力声明，确保在多会话场景中的正确协作。
  • 支持多种传输通道的潜在扩展（如 Stdio、SSE、WebSocket 等），以实现与不同前端的灵活对接。
  • JSON-RPC 风格的请求/响应处理：遵循 MCP 的协议格式，返回带有 ok、数据、错误信息等字段的响应。
• 安装步骤
  • 在合适的开发环境中将代码编译为可执行程序（Go 语言环境即可编译）。
  • 构建后运行生成的 MCP 服务器可执行文件。启动后服务器会监听并通过标准传输通道与 MCP 客户端通信。
  • 根据目标平台的需要，可能还需配置本地环境变量（如根目录、工作区等路径）。
• 服务器配置（给 MCP 客户端的配置信息，JSON 格式） 说明：MCP 客户端需要的一组连接信息，以便与服务器建立连接并发起 RPC 调用。以下示例中的 server_name 与 command 对应代码中的实现细节： { "server_name": "xstream-local-mcp", "command": "./xstream-mcp-server", "args": [] } 注释说明：
  • server_name: MCP 服务器在客户端端的唯一标识，可与代码中的服务器实例名称保持一致（如 xstream-local-mcp）。
  • command: 启动 MCP 服务器的可执行文件路径。示例为本仓库构建输出的 xstream-mcp-server（若在其他目录运行，请使用实际路径）。
  • args: 启动参数数组。当前实现不强制要求命令行参数，因此可以留空或添加需要的运行时参数。
• 基本使用方法
  • 启动服务器后，客户端通过 MCP 协议向服务器发送请求，调用工具、获取工作区信息、读取资源等。
  • 通过返回的 JSON 结果来解析工具执行结果、诊断信息等，结合 LLM 的上下文能力，完成自动化诊断、协同工作等任务。
  • 如需扩展，请参考代码中对不同平台的实现（Linux、Windows、Android、iOS 等分支），以及工具集的添加方式。