Phoebe MCP 服务器(Node 实现)
- 项目简介
- 该仓库实现了一个完整的 MCP 服务器,用以对接 LLM 客户端,提供资源与工具的注册、执行,以及对 Prompt 模板的渲染与交互能力。服务器实现遵循 MCP 的核心设计,支持通过 JSON-RPC 处理请求、返回响应,并可通过多种传输协议进行通信(如标准输入输出、HTTP 流式传输等)。
- 服务器内部包含两个内置工具示例:一个用于执行代码的 codeTool,以及一个文档检索工具 docsSearchTool,便于在 MCP 客户端调试与学习过程中使用。
- 主要功能点
- 注册与执行工具:服务器注册可用的工具集合,并在收到调用请求时执行对应的处理逻辑。
- 资源与工具渲染:服务器端维护工具元数据和能力声明,供客户端查询与协作使用。
- 支持多传输协议:默认提供基于标准 I/O 的本地化服务器、以及基于 Express 的 HTTP 服务器实现,便于在不同运行环境中部署。
- 安全与会话管理:通过鉴权头部、日志与参数处理,提供可控的访问和操作能力,并为客户端对话提供上下文能力。
- 运行与配置:提供 CLI 选项解析与工具选择逻辑,允许按需启用/禁用工具,配置日志等级等运行属性。
- 安装步骤
- 获取代码:获取本仓库中 mcp-server 相关代码,或通过该仓库的构建产物进行部署。
- 安装依赖与编译:在包含 MCP 服务实现的模块目录下安装依赖并构建,确保 TypeScript 代码编译为可运行的 JavaScript。
- 运行方式选择:可通过标准输入输出方式直接运行,或通过 HTTP 端口暴露服务并接入 MCP 客户端进行通信。
- 服务器配置(供 MCP 客户端使用的配置示例说明)
下列信息用于 MCP 客户端的连接配置,客户端无需包含服务器端源码,只需按照该 JSON 配置启动与连接即可。
- server name:phoebe_ebird_api
- command:npx
- args:[-y, phoebe-ebird-mcp]
- 环境变量示例(请在客户端配置中提供):EBIRD_API_KEY: 你的 API Key 说明:该配置对应仓库中 MCP 服务器的默认 server 名称和启动命令组合。客户端通过该配置即可启动一个外部进程来运行 MCP 服务器,并与其进行 JSON-RPC 通信。
- 基本使用方法
- 启动方式
- 通过命令行进入服务器模块所在目录,使用上述配置中的命令组合启动 MCP 服务器进程(通常在客户端工具中以托管方式执行该命令)。
- 客户端连接
- 启动后,MCP 客户端将通过 JSON-RPC 与服务器建立通信,查询可用工具、发送工具调用请求、以及获取服务器提供的能力与资源信息。
- 运行与调试
- 通过服务器提供的工具(如 codeTool)执行特定的任务,或通过 docsSearchTool 查询相关文档来帮助完成工作流。
- 启动方式