2020117 MCP Server
使用说明(MCP 服务器端)
-
项目简介
- 本仓库实现了一个基于 MCP 的服务端,核心职责包括:托管和管理资源(Resources)、注册和执行工具(Tools)、以及定义/渲染 Prompts,以标准化的方式向 MCP 客户端(如 Claude Code、Cursor 等编辑器工具)提供上下文信息与能力。服务器通过 JSON-RPC 与客户端通信,支持多传输协议(如 Stdio/WebSocket 等),并具备会话管理与能力声明能力。
-
主要功能点
- MCP 核心协议实现:接收/解析 MCP 请求,返回 MCP 响应,按 JSON-RPC 规范处理。
- 资源、工具、Prompts 的暴露与查询:允许客户端通过 MCP 读取资源、注册工具、获取和渲染 Prompt 模板。
- MCP 服务器端传输与交互:通过 Stdio、WebSocket 等传输实现与客户端的通信。
- 只读网关(Gateway)与可扩展的 MCP 服务:提供门控的只读网关,便于上下游系统通过 MCP 进行集成。
-
安装步骤
-
- 将仓库克隆到本地
-
- 进入 mcp-server 目录并安装依赖
-
- 构建/编译 MCP 服务器
-
- 如需网关(Gateway)能力,按说明启动 gateway 服务
-
-
服务器配置(客户机配置 MCP 服务器的示例信息)
- MCP 客户端需要在配置中指定 MCP 服务器信息(名称、启动命令及参数等),示例如下(以文本描述说明,无代码块):
- serverName(服务器标识):2020117 MCP Server
- command(启动命令):node
- args(启动参数数组):[“/path/to/2020117/mcp-server/dist/index.js”]
- env(环境变量,可选,示例包含 API KEY,用于平台接口访问):
- API_2020117_KEY: neogrp_xxx
- 客户端实际使用时请将路径替换为你部署环境中 MCP 服务器可执行文件的位置,并按需要传入其他环境变量(如 API Key、relays 等),以确保 MCP 服务端可以正确访问外部资源。
- MCP 客户端需要在配置中指定 MCP 服务器信息(名称、启动命令及参数等),示例如下(以文本描述说明,无代码块):
-
基本使用方法
- 启动 MCP 服务器,确保 MCP 服务端进程在运行状态。
- 在 MCP 客户端(如 Claude Code / Cursor 等)中添加 MCP 服务器配置,指向上述 serverName、command、args 等信息。 MCP 客户端通过 JSON-RPC 调用 MCP 服务端暴露的工具和资源接口,获取响应并在编辑器中进行相应的操作。
-
重要注意
- 该实现包含网关(gateway)和网关服务器(gateway-server)的两个入口, gateway 提供对 MCP 客户端的 Read(只读)能力,gateway-server 通过标准输入/输出和其他传输通道暴露 MCP 接口。
- 部署时请确保相关密钥、API key、 relay 地址等环境变量配置正确,以保证 MCP 服务端的安全性与互操作性。
- MCP 客户端在连接 MCP 服务器时,需提供启动命令与参数(如 dist/index.js)的准确路径,以便正确加载 MCP 服务端。