MCP Server Bridge Restish

Bridge Restish - MCP 服务

概述

此 MCP 服务充当桥接层，使大模型能够访问你的自定义 HTTP API 服务。它会从你的 HTTP API 服务获取工具定义，并动态将其注册为大模型可以调用的 MCP 工具。

工作原理

1. 获取工具定义：从 ${BASE_URL}/tools 端点获取可用的工具定义
2. 注册 MCP 工具：根据获取的工具定义动态注册 MCP 工具
3. 代理 API 调用：当大模型调用工具时，将请求转发到相应的 HTTP API 端点

HTTP API 服务要求

说明

你的 HTTP API 服务应实现以下规范：

运行一个示例服务以供演示。

git clone https://github.com/high-u/mcp-server-bridge-restish.git
cd mcp-server-bridge-restish
node example/server.js 3000

工具定义端点

GET ${BASE_URL}/tools 应返回一个工具定义数组：

curl http://localhost:3000/tools

响应示例：

[
  {
    "name": "get_time",
    "description": "Get current date and time",
    "schema": {
      "type": "object",
      "properties": {},
      "required": []
    },
    "endpoint": "/get_time",
    "method": "get"
  },
  {
    "name": "get_birthday",
    "description": "Get a birthday for a given name",
    "schema": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "The name to get birthday for"
        }
      },
      "required": [
        "name"
      ]
    },
    "endpoint": "/get_birthday",
    "method": "get"
  }
]

工具执行端点

每个工具都通过其指定的端点和方法执行：

• GET ${BASE_URL}/get_time → 以 JSON 格式返回当前时间

curl http://localhost:3000/get_time

{
  "time": "2025-06-22T03:53:49.675Z",
  "timestamp": 1750564429675
}

• GET ${BASE_URL}/get_birthday?name=XXX → 以 JSON 格式返回 XXX 的生日

curl "http://localhost:3000/get_birthday?name=John"

{
  "name": "John",
  "birthday": "1973-11-08"
}

响应架构由你决定。如何使用它由大模型决定。

使用方法

配置 Claude Desktop

将以下内容添加到你的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "bridge-restish": {
      "command": "mcp-server-bridge-restish",
      "args": ["http://localhost:3000", "server-api-key"],
      "env": {
        "BASE_URL": "http://localhost:3000",
        "AUTH_TYPE": "Bearer",
        "API_KEY": "server-api-key"
      }
    }
  }
}

“BASE_URL”为必填项。根据需要设置“API_KEY”和“AUTH_TYPE”。

用户提示词示例

What time is it?

How old is John this year?