MCP 连接器 - 中文文档

项目简介

MCP Connect 是一个用于连接云服务与本地 MCP（模型上下文协议）服务器的工具。它支持将本地的 MCP 服务器暴露到互联网，并通过 API 方式调用本地的服务能力。此工具具有以下功能：

• 云集成：允许云服务通过 HTTP 协议访问本地 MCP 服务器
• 协议转换：实现从 HTTP 请求到标准输入输出（stdio）命令的转换
• 安全性：提供基于令牌的身份验证机制，确保 API 调用的安全性
• 可扩展性：支持多种不同的 MCP 服务，并且可以通过配置轻松添加新的服务

快速入门指南

克隆仓库

使用以下命令克隆 MCP Connect 仓库：

git clone https://github.com/your-repository-url.git
cd mcp-connect

配置环境变量

创建并编辑 config.env 文件，添加以下内容（根据实际需求修改）：

AUTH_TOKEN=your_auth_token_here
PORT=3000
LOG_LEVEL=info
NGROK_AUTH_TOKEN=your_ngrok_auth_token_here

安装依赖

在项目根目录运行以下命令安装所需的依赖项：

npm install

运行应用

使用以下命令启动 MCP Connect 服务：

node index.js

使用 Ngrok 搭建隧道（可选）

如果您需要将本地服务暴露到互联网，可以使用 Ngrok 创建隧道。首先安装 Ngrok：

# 下载并安装 Ngrok
go install -v github.com/caddyserver/forwarding/v2/cmd/ngrok@latest

然后在项目目录下创建 ngrok.yml 文件，添加以下内容：

tunnels:
  mcp-connector:
    addr: http://localhost:3000
    proto: http

运行 Ngrok：

ngrok run --config=ngrok.yml

API 端点

MCP Connect 提供以下两个主要端点：

/health - 健康检查

• 请求方式：GET
• 描述：用于检查 MCP Connect 服务是否正常运行

/bridge - 主桥接端点

• 请求方式：POST
• 描述：接收来自云服务的请求，并将其转发到本地 MCP 服务器
• 请求示例：

{
  "method": "tools/list",
  "serverPath": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-github"
  ],
  "params": {},
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "<your_github_personal_access_token>"
  }
}

认证机制

MCP Connect 使用基于令牌的认证系统。在请求头中添加 Authorization 字段，格式为：

curl -X POST http://localhost:3000/bridge \
     -H "Authorization: Bearer <your_auth_token>"

配置参数

以下是 MCP Connect 支持的环境变量及其默认值：

• AUTH_TOKEN：API 认证令牌（可选，默认为空）
• PORT：HTTP 服务监听端口（必填，默认为 3000）
• LOG_LEVEL：日志级别（必填，支持 debug, info, warn, error）
• NGROK_AUTH_TOKEN：Ngrok 认证令牌（可选，默认为空）

使用 MCP Connect 访问本地 MCP 服务器

以下是一个使用 MCP Connect 访问本地 MCP 服务器的示例：

安装 GitHub MCP 服务

npx -y @modelcontextprotocol/server-github

列出可用工具

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

调用具体工具

curl -X POST http://localhost:3000/bridge \
     -d '{
       "method": "tools/run",
       "serverPath": "npx",
       "args": [
         "@modelcontextprotocol/server-github",
         "your_command"
       ],
       "params": {},
       "env": {
         "GITHUB_PERSONAL_ACCESS_TOKEN": "<your_github_personal_access_token>"
       }
     }'

项目截图

以下是 MCP Connect 的使用示例截图：

链接

MCP 连接器 示例页面