MCP Bridge

🚀 MCP-Bridge 中文文檔

MCP-Bridge 是一款強大的橋樑工具，它能無縫連接 OpenAI API 和推理引擎。通過在請求中添加所有可用的 MCP 工具定義，將請求精準轉發到推理引擎，處理工具調用結果後，再把結果返回給 OpenAI API，極大提升了工作效率和數據交互的流暢性。

🚀 快速開始

MCP-Bridge 是一個連接 OpenAI API 和推理引擎的橋樑工具。它通過在請求中添加所有可用的 MCP 工具定義，將請求轉發到推理引擎，並處理工具調用的結果，最終將結果返回給 OpenAI API。

✨ 主要特性

• 支持多種 MCP 服務器：可靈活配置多個 MCP 服務器，每個服務器具備不同的命令和參數，滿足多樣化需求。
• API Key 認證：通過配置 API 密鑰來保護服務器，為服務訪問加上安全鎖，確保只有授權用戶可以訪問服務。
• 靈活的採樣設置：支持自定義採樣超時時間和模型性能參數（如智能度、成本和速度），讓使用更加個性化。
• 網絡配置：能根據實際需求調整服務器的綁定地址和端口，適應不同的網絡環境。
• 日誌記錄：支持不同級別的日誌輸出，無論是調試還是監控，都能輕鬆應對。

📦 安裝指南

1. 下載代碼

從 GitHub 克隆項目倉庫：

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

2. 配置環境

編輯 config.json 文件，根據需求填寫推理服務器地址、MCP 服務器命令和其他參數。例如：

{
    "inference_server": {
        "base_url": "http://localhost:8000/v1",
        "api_key": "None"
    },
    "mcp_servers": {
        "fetch": {
            "command": "uvx",
            "args": ["mcp-server-fetch"]
        }
    }
}

3. 啟動服務

運行以下命令啟動 MCP-Bridge：

python main.py

📚 詳細文檔

配置詳解

1. 基本配置

• 推理服務器：指定推理引擎的 API 地址和密鑰。
• MCP 服務器：定義可用工具及其調用命令。

2. 安全設置

啟用 API Key 認證：

{
    "security": {
        "auth": {
            "enabled": true,
            "api_keys": [
                {"key": "your-api-key"}
            ]
        }
    }
}

3. 網絡配置

調整服務器的綁定地址和端口：

{
    "network": {
        "host": "0.0.0.0",
        "port": 9090
    }
}

4. 日誌設置

控制日誌輸出級別：

{
    "logging": {
        "log_level": "DEBUG"
    }
}

💻 使用示例

基礎用法

發送一個簡單的請求到 MCP-Bridge，包含工具調用：

POST /v1/chat/completions HTTP/1.1
Content-Type: application/json
Authorization: Bearer your-api-key

{
    "model": "gpt-4",
    "messages": [
        {
            "role": "user",
            "content": "請列出所有可用的 MCP 工具。"
        }
    ],
    "tools": {
        "enabled": true
    }
}

高級用法

MCP-Bridge 返回工具調用的結果並轉發到推理引擎，最終將響應返回給 OpenAI API。

🔧 技術細節

項目結構

mcp-bridge/
├── main.py          # 主程序入口
├── config.json      # 配置文件
├── README.md        # 用戶文檔
└── requirements.txt # 依賴管理文件

🤝 貢獻與支持

如果遇到問題或有任何建議，請在 GitHub Issues 提交反饋。我們也歡迎社區貢獻代碼和文檔。

📄 許可證

MCP-Bridge 採用 MIT 許可證，詳情請查看 LICENSE 文件。

感謝使用 MCP-Bridge！如果有任何問題，請隨時聯繫我們。