Claude MCP 后端服务集合

使用说明(Markdown 格式)

  • 项目简介

    • 该仓库包含若干基于 MCP(Model Context Protocol)的后端服务器实现,覆盖资源读取、工具调用、以及对话提示模板等能力,旨在向 LLM 客户端提供可扩展的上下文服务框架。
  • 主要功能点

    • 资源管理与数据访问:提供对资源/数据的读取与列举能力(如数据库、存储等的资源列表与读取接口)。
    • 工具注册与执行:注册可供 LLM 调用的工具(Tools),并在客户端请求时执行对应操作,返回结果。
    • Prompts 与上下文:定义/渲染 Prompt 模板,支持将模板化上下文渲染给客户端。
    • 跨传输协议支持:服务器实现通常支持多种传输协议(如 STDIO、SSE、WebSocket/HTTP 形式),以适配不同的客户端接入方式。
    • JSON-RPC 通信:遵循 MCP 的标准通信格式,接收请求并返回 JSON-RPC 响应。
  • 安装步骤

    • 克隆仓库或将相关 MCP 服务目录进入工作区。
    • 进入具体服务器子目录(如 mongodb、jira-bridge、supabase 等)。
    • 安装所需依赖(如 Node.js 环境、npm/yarn、或对应的 TS/JS 构建链)。
    • 构建并启动服务器入口。常见入口使用 Node 直接运行对应的入口文件,或通过打包产出 dist/index.js 之类的可执行文件来启动。
  • 服务器配置(MCP 客户端使用,不需要客户端代码)

    • 说明:MCP 客户端需要知道如何启动并连接到 MCP 服务器。配置以 JSON 格式描述 server name、启动命令及参数等信息,便于客户端在需要时动态启动并连接。
    • 配置字段示例(描述性文本,非直接运行代码): { "server_name": "mongodb-mcp", "command": "node", "args": ["dist/index.js"], "transport": "stdio" // 可选传输类型:stdio、sse、http,依据实际服务器实现选择 "env": { "MONGODB_CONNECTION_STRING": "mongodb://localhost:27017", "MONGODB_DATABASE": "test", "MAX_DOCUMENTS": "100", "QUERY_TIMEOUT": "30000", "ALLOW_WRITES": "true" }, "description": "MongoDB MCP 服务入口,提供对数据库的查询与操作工具。" }
    • 注释说明:
      • server_name: 服务的唯一标识名称,客户端通过名称选择启动对应 MCP 服务。
      • command: 启动入口命令(如 node、npm run start 等),根据实际部署入口调整。
      • args: 启动命令的参数列表,指向服务的实现入口文件(如 dist/index.js)。
      • transport: 客户端与服务器之间的通信传输方式,需与服务器实现兼容。
      • env: 如需环境变量,请在此字段声明。
      • description: 对该 MCP 服务的简要说明,便于客户端理解用途。
  • 基本使用方法

    • 启动与连接:MCP 客户端根据配置启动对应的 MCP 服务器,并通过 JSON-RPC 与之交互,完成资源读取、工具调用、以及获取 Prompt 的能力。
    • 调用流程:LLM 客户端通过 MCP 接口请求工具执行、资源访问等,服务器返回标准化的响应,便于后续对话管理。
    • 安全与扩展:服务器实现了会话管理、能力声明,并支持多种传输协议,便于在不同环境下扩展和隔离。
  • 实践要点

    • 仓库中包含多项具体实现(如 Jira Bridge、MongoDB、Supabase、Docx/PPTX 等场景),可按业务场景选择合适的 MCP 服务器进行部署与使用。
    • 由于具体入口、构建及部署方式可能因环境而异,请结合具体子目录中的入口文件和文档进行实际部署。
  • 适用场景

    • 需要以统一接口向大模型提供外部工具、数据资源和 Prompt 模板的应用场景。

服务器信息