mcp-remote-server

mcp-remote-server

site icon
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

安装教程

  1. 克隆项目并安装依赖:
git clone <repository-url>
cd mcp-remote-server
bun install
  1. 设置控制平面 URL:
export MCP_CONTROL_PLANE_URL="https://your-config-endpoint"
  1. 运行服务器:
bun run index.ts

调试方式

  1. 检查控制平面 URL 是否正确设置:
echo $MCP_CONTROL_PLANE_URL
  1. 查看服务器日志以确认配置加载和刷新情况。

  2. 使用 MCP 客户端测试工具、资源和提示的功能。

许可证

None