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"
  }]
}

Handler API 要求

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

• 工具处理程序：返回 JSON，该 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 进行类型检查和 linting。我选择 Biome 的原因与 Bun 相同。我想要一些不同的东西，并且我希望 JS 有一个类似 gofmt 的工具。这是一个好的开始。