MCP Bridge API
2025.04.16
2
JavaScriptRESTful代理LLM集成开发效率
MCP Bridge API 是一个轻量级、与LLM无关的RESTful代理，用于连接多个模型上下文协议（MCP）服务器，并通过统一的REST API暴露其功能。它使任何平台上的任何客户端都能够利用MCP功能，而无需受限于进程执行约束。MCP Bridge 完全独立，设计用于与任何LLM后端配合使用，使其适应性强、模块化且面向未来。此外，MCP Bridge 还提供了基于风险级别的执行控制，从标准执行到确认工作流和Docker隔离，同时保持与标准MCP客户端的向后兼容性。MCP-Gemini Agent 是一个Python客户端，集成了Google的Gemini API与MCP Bridge，通过智能的LLM驱动界面实现与MCP工具的自然语言交互。
View on GitHub
Overview
基本能力
产品定位
MCP Bridge API 是一个轻量级的RESTful代理，用于连接和管理多个MCP服务器，提供统一的API接口，使客户端能够跨平台使用MCP功能。
核心功能
- 多服务器连接：支持连接多个MCP服务器（STDIO或SSE）。
- 统一REST API：提供统一的REST API接口，简化客户端与MCP服务器的交互。
- 风险级别控制：支持低、中、高三种风险级别的执行控制，包括确认工作流和Docker隔离。
- MCP-Gemini Agent：集成Google Gemini API，提供自然语言交互和多步推理功能。
- 配置灵活性：通过JSON配置文件灵活配置MCP服务器和风险级别。
适用场景
- 跨平台应用：适用于移动设备、浏览器和其他无法直接运行MCP服务器的平台。
- 资源受限环境：在资源受限的环境中，通过代理减少冗余和资源使用。
- 安全敏感操作：通过风险级别控制和安全确认流程，执行敏感操作。
- 复杂操作：通过MCP-Gemini Agent实现多步推理和复杂操作的自然语言交互。
工具列表
- MCP Bridge：Node.js实现的RESTful代理，用于连接和管理MCP服务器。
- MCP-Gemini Agent：Python客户端，集成Google Gemini API，提供自然语言交互功能。
常见问题解答
- 如何配置风险级别？：通过
mcp_config.json文件配置每个MCP服务器的风险级别。 - 如何启动MCP Bridge？：使用
node mcp-bridge.js命令启动。 - 如何启动MCP-Gemini Agent？：使用
python llm_test.py命令启动。
使用教程
使用依赖
- Node.js 18+：用于运行MCP Bridge。
- Python 3.8+：用于运行MCP-Gemini Agent。
安装教程
MCP Bridge
# 安装依赖
npm install express cors morgan uuid
# 启动服务器
node mcp-bridge.js
MCP-Gemini Agent
# 安装依赖
pip install google-generativeai requests rich
# 启动代理
python llm_test.py
调试方式
- 检查服务器状态：访问
/health端点获取服务器健康状态。 - 列出服务器：访问
/servers端点列出所有连接的MCP服务器。 - 执行工具：使用
/servers/{serverId}/tools/{toolName}端点执行特定工具。