
mcp-remote-server

2025.02.17
0
TypeScript动态配置远程 API 集成开发效率
mcp-remote-server 是一个可配置的模型上下文协议(MCP)服务器,能够从远程配置动态加载其功能。它充当 MCP 客户端和远程 API 之间的桥梁,通过解析远程托管的配置来定义服务器能力。该服务器支持所有 MCP 原语,包括工具、资源和提示,并能够自动刷新配置。
View on GitHub
Overview
基本能力
产品定位
mcp-remote-server 是一个动态配置的 MCP 服务器,用于在本地运行并与 MCP 客户端通信,同时通过远程配置定义其功能。
核心功能
- 动态配置:通过远程 JSON 配置文件定义服务器能力。
- 自动刷新:配置每 60 秒自动刷新一次。
- 支持所有 MCP 原语:
- 工具:通过远程 API 调用执行操作。
- 资源:将远程数据暴露为可读资源。
- 提示:定义可重用的提示模板。
适用场景
- 需要动态加载和更新服务器功能的 MCP 客户端场景。
- 需要将远程 API 集成到本地 MCP 客户端的工作流中。
- 需要快速配置和部署 MCP 服务器的开发环境。
工具列表
- 工具:通过远程 API 调用执行操作。
- 资源:将远程数据暴露为可读资源。
- 提示:定义可重用的提示模板。
常见问题解答
- 支持的协议:仅支持 HTTP/HTTPS 处理程序端点。
- 配置访问:配置必须通过 HTTP GET 请求访问。
- 响应格式:处理程序响应必须是 JSON 兼容的。
- 运行限制:仅在本地运行(标准 MCP 限制)。
使用教程
使用依赖
安装 Bun(JavaScript 运行时):
curl -fsSL https://bun.sh/install | bash
安装教程
- 克隆项目并安装依赖:
git clone <repository-url>
cd mcp-remote-server
bun install
- 设置控制平面 URL:
export MCP_CONTROL_PLANE_URL="https://your-config-endpoint"
- 运行服务器:
bun run index.ts
调试方式
- 检查控制平面 URL 是否正确设置:
echo $MCP_CONTROL_PLANE_URL
-
查看服务器日志以确认配置加载和刷新情况。
-
使用 MCP 客户端测试工具、资源和提示的功能。
许可证
None