MCP Bridge

🚀 MCP 連接器 - 中文文檔

MCP Connect 是一款強大的工具，它能將雲服務與本地 MCP（模型上下文協議）服務器相連接。通過將本地 MCP 服務器暴露到互聯網，用戶可藉助 API 調用本地服務能力，為雲與本地服務的交互提供了便捷途徑。

🚀 快速開始

克隆倉庫

使用以下命令克隆 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

✨ 主要特性

• 雲集成：允許雲服務通過 HTTP 協議訪問本地 MCP 服務器。
• 協議轉換：實現從 HTTP 請求到標準輸入輸出（stdio）命令的轉換。
• 安全性：提供基於令牌的身份驗證機制，確保 API 調用的安全性。
• 可擴展性：支持多種不同的 MCP 服務，並且可以通過配置輕鬆添加新的服務。

📦 安裝指南

使用 Ngrok 搭建隧道（可選）

如果您需要將本地服務暴露到互聯網，可以使用 Ngrok 創建隧道。

1. 首先安裝 Ngrok：

# 下載並安裝 Ngrok
go install -v github.com/caddyserver/forwarding/v2/cmd/ngrok@latest

2. 然後在項目目錄下創建 ngrok.yml 文件，添加以下內容：

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

3. 運行 Ngrok：

ngrok run --config=ngrok.yml

💻 使用示例

基礎用法

安裝 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>"
       }
     }'

📚 詳細文檔

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 支持的環境變量及其默認值：

📄 項目截圖

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

📄 鏈接

MCP 連接器 示例頁面