spanner-mycli MCP 服务端实现

关键词

模型上下文协议JSON-RPC资源管理工具执行提示模板

使用说明

  • 项目简介
    • spanner-mycli 在代码中实现了一个可选的 MCP 服务器端，用以向 LLM 客户端以标准化的方式提供上下文信息、资源、工具和 Prompts，并通过 JSON-RPC 与客户端交互。服务器侧具备会话管理、能力声明，以及对不同传输协议（如 Stdio、SSE、WebSocket 等）及可扩展能力的支持能力，方便将 Spanner 的数据与操作暴露给大语言模型进行更丰富的对话式应用。
  • 主要功能点
    • Resources：提供对 Spanner 资源（数据库、表等）的访问能力管理（资源托管与访问）。
    • Tools：注册并执行外部功能调用（如查询、DDL 操作、辅助任务等）。
    • Prompts：定义与渲染 Prompt 模板，支持定制化 LLM 交互模式。
    • JSON-RPC 通信：服务器端通过 JSON-RPC 处理客户端请求，返回标准化的 JSON-RPC 响应或通知。
    • 会话与能力声明：服务器端负责维持会话状态、权限与能力声明，确保多客户端并发安全访问。
    • 多传输协议：理论上支持多种传输通道，方便嵌入到不同的应用环境与前端。
  • 安装与运行步骤
    • 构建与部署
      • 将代码在具备 Go 语言环境的机器上进行编译运行即可（仓库为 Go 项目，包含大量测试与集成逻辑）。
    • 启动 MCP 服务器
      • 以 MCP 服务器模式启动后端服务，供 LLM 客户端通过 MCP 客户端连接并发送 JSON-RPC 请求。
    • 客户端接入（需通过 MCP 客户端连接）
      • MCP 客户端需要配置一个服务器端信息（服务器名称、启动命令及参数等）。客户端将通过 MCP 的 RPC 通道向服务器发出请求（读取资源、执行工具、获取 Prompt 等）。
  • 服务器配置（JSON 配置示例） 备注：以下配置用于 MCP 客户端连接和服务器启动示例，实际参数请按具体环境替换为真实值。MCP 客户端不需要你提供客户端的配置信，只需将该配置用于 MCP 服务器端启动。 { "server_name": "spanner-mycli-mcp", "command": "spanner-mycli", "args": [ "--mcp" // 其他必要参数，根据环境决定 ], "description": "MCP 服务器实例，用于向 MCP 客户端暴露 Resources、Tools、Prompts 等上下文服务。", "notes": [ "该服务器通过 MCP 协议处理请求与响应，客户端通过 MCP 客户端进行调用。", "启动后，服务器将接受来自客户端的 JSON-RPC 请求并返回相应结果或通知。", "如需集成特定的资源、工具与提示，请在服务器启动后配置相应的资源/工具/模板。" ] }
  • 基本使用方法
    • 启动阶段
      • 在具备运行环境的服务器上，使用上述命令启动 MCP 服务端。确保网络和认证设置就绪（如需要凭证、端点等）。
    • 客户端接入阶段（LLM 客户端侧操作，不在此处展示）
      • 使用 MCP 客户端连接到上述 MCP 服务器，发送 JSON-RPC 请求以读取资源、执行工具、获取或渲染 Prompt 等。
    • 交互阶段
      • LLM 客户端发送标准化的请求，服务器返回 JSON-RPC 响应，或透传通知，支持会话管理与能力声明的协作。
  • 重要说明
    • 本仓库实现了 MCP 服务器端相关的集成测试，包含如何在内存传输通道上进行 MCP 客户端/服务器的交互测试，确认服务器端对工具执行、读取资源、获取 Prompt 等功能的支持。
    • 由于 MCP 是一个较新的协议，实际生产使用中应结合安全鉴权、会话隔离、流量控制等机制进行部署与测试。

服务器信息

访问项目