mcp-remote-server

这是一个基于代码库补充了更多技术细节的增强版 README：

mcp-remote-server

一个可配置的模型上下文协议（MCP）服务，可从远程配置动态加载自身能力。它借助 ModelContextProtocol 创建一个能够与本地 MCP 客户端通信的本地服务。

概述

mcp-remote-server 充当 MCP 客户端与远程 API 之间的桥梁。它会解析托管在远程的配置（通过 MCP_CONTROL_PLANE_URL 指定），其中包含一系列工具、资源和提示词，每项都指向远程 API 端点。

主要功能

• 动态配置：通过远程 JSON 配置定义服务能力
• 自动刷新：每 60 秒自动刷新配置
• 支持所有 MCP 基本元素：
  • 工具：通过远程 API 调用执行操作
  • 资源：将远程数据作为可读取的资源提供
  • 提示词：定义可复用的提示词模板

配置格式

{
  "tools": [{
    "name": "tool-name",
    "description": "Tool description",
    "inputSchema": {
      "type": "object",
      "properties": {
        // JSON Schema for tool inputs
      }
    },
    "handler": "https://api.example.com/tool-endpoint"
  }],
  "resources": [{
    "uri": "resource://identifier",
    "name": "Resource Name",
    "description": "Resource description",
    "mimeType": "application/json",
    "handler": "https://api.example.com/resource-endpoint"
  }],
  "prompts": [{
    "name": "prompt-name",
    "description": "Prompt description",
    "arguments": [{
      "name": "arg-name",
      "description": "Argument description",
      "required": true
    }],
    "handler": "https://api.example.com/prompt-endpoint"
  }]
}

处理程序 API 要求

远程处理程序必须返回格式正确的响应：

• 工具处理程序：返回 JSON，该内容会被转换为字符串并封装在 MCP 工具响应中
• 资源处理程序：返回与指定 mimeType 匹配的内容
• 提示词处理程序：返回字符串（会自动封装为一条消息）或 MCP 格式的消息数组

安装

bun install

用法

1. 设置控制平面 URL：

export MCP_CONTROL_PLANE_URL="https://your-config-endpoint"

2. 运行服务：

bun run index.ts

限制

• 仅支持 HTTP/HTTPS 处理程序端点
• 配置必须可通过 HTTP GET 请求访问
• 处理程序响应必须兼容 JSON
• 仅在本地运行（MCP 的标准限制）

此项目使用 bun v1.1.32 中的 bun init 创建。Bun 是一款快速的一体化 JavaScript 运行时。我选择 Bun 是因为它速度快，而且我想尝试一些不一样的东西。

此项目还使用 Biome 进行类型检查和代码检查。我选择 Biome 的原因与选择 Bun 相同：我想尝试一些不一样的东西，而且希望 JS 能有一个类似 gofmt 的工具。这是一个不错的开始。