MCP-Bridge

MCP-Bridge

提供一个兼容OpenAI的端点以调用MCP工具的中间件。

GitHub
Created BySecretiveShellSecretiveShell

Discord Static Badge Static Badge

概述

MCP-Bridge 是一个桥接工具，允许开发者通过 OpenAI API 接口使用 MCP (Multimodal ChatGPT Plugins) 工具，无需对 MCP 提供显式支持。

安装方法

使用 Docker (推荐)

  1. 克隆仓库

  2. 配置 compose.yml 文件，选择以下任一方法配置 config.json:

    environment:
  # 选择以下一种方法:
  - MCP_BRIDGE__CONFIG__FILE=config.json # 需要挂载卷
  - MCP_BRIDGE__CONFIG__HTTP_URL=http://example.com/config.json
  - MCP_BRIDGE__CONFIG__JSON={"inference_server":{"base_url":"http://example.com/v1","api_key":"None"},"mcp_servers":{"fetch":{"command":"uvx","args":["mcp-server-fetch"]}}}

# 如使用文件方式，添加卷挂载:
volumes:
  - ./config.json:/mcp_bridge/config.json

  3. 启动服务

    docker-compose up --build -d

手动安装

  1. 克隆仓库

  2. 安装依赖: uv sync

  3. 创建配置文件 config.json:

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

  4. 启动应用: uv run mcp_bridge/main.py

使用方法

  1. 访问文档页面了解 API: http://localhost:8000/docs
  2. 测试配置是否正确:
    • 使用 MCP-CLI: npx @wong2/mcp-cli --sse http://localhost:8000/mcp-server/sse
    • 或访问端点列出所有可用工具

API 认证

如需启用 API 密钥认证，在 config.json 中添加:

{
    "api_key": "your-secure-api-key-here"
}

请求时添加头部: Authorization: Bearer your-secure-api-key-here

完整配置示例

{
    "inference_server": {
        "base_url": "http://localhost:8000/v1",
        "api_key": "None"
    },
    "mcp_servers": {
        "fetch": {
            "command": "uvx",
            "args": ["mcp-server-fetch"]
        }
    },
    "network": {
        "host": "0.0.0.0",
        "port": 9090
    },
    "logging": {
        "log_level": "DEBUG"
    },
    "api_key": "your-secure-api-key-here"
}

支持