MCP 桥接快速开始指南

MCP 桥接是一个轻量级工具，允许基于云的 AI 服务通过 HTTP/HTTPS 与本地 Stdio 的 MCP 服务器交互。

功能亮点

• 协议转换：HTTP/HTTPS → Stdio
• 云集成：使云 AI 服务能访问本地资源
• 内置隧道：支持 Ngrok
• 无需修改：与现有 MCP 服务器无缝协作

架构

[云 AI 工具] <--HTTPS/SSE--> [Node.js 桥接] <--stdio--> [MCP 服务器]
   (远程)           隧道          (本地)                (本地)

安装与设置

1. 克隆并进入项目

   git clone https://github.com/modelcontextprotocol/mcp-bridge.git
   cd mcp-bridge
   

2. 配置环境

   cp .env.example .env
   # 编辑.env文件设置PORT和AUTH_TOKEN
   

3. 安装依赖

   npm install
   

4. 启动桥接

   npm run build
   npm run start
   # 或开发模式: npm run dev
   

使用 Ngrok 隧道（可选）

1. 获取 Ngrok 令牌并添加到 .env：

   NGROK_AUTH_TOKEN=your_ngrok_auth_token
   

2. 启动带隧道的桥接：

   npm run start:tunnel
   # 或开发模式: npm run dev:tunnel
   

使用示例

列出工具

curl -X POST http://localhost:3000/bridge \
     -H "Authorization: Bearer <your_auth_token>" \
     -d '{
       "method": "tools/list",
       "serverPath": "npx",
       "args": ["-y", "@modelcontextprotocol/server-github"],
       "params": {},
       "env": {
         "GITHUB_PERSONAL_ACCESS_TOKEN": "<your_github_pat>"
       }
     }'

调用工具

curl -X POST http://localhost:3000/bridge \
     -H "Authorization: Bearer <your_auth_token>" \
     -d '{
       "method": "tools/call",
       "serverPath": "npx",
       "args": ["-y", "@modelcontextprotocol/server-github"],
       "params": {
         "name": "search_repositories",
         "arguments": {
            "query": "modelcontextprotocol"
         }
       },
       "env": {
         "GITHUB_PERSONAL_ACCESS_TOKEN": "<your_github_pat>"
       }
     }'

环境配置

更多详情请访问 GitHub 仓库。