🚀 MCP 桥接 API 文档

MCP 桥接 API 是一款强大的桥梁服务，借助 RESTful 接口，可与多个 MCP 服务器实现交互。它具备多语言集成能力，还拥有丰富的功能模块，能为开发者提供便捷、高效的开发体验。

🚀 快速开始

服务器端安装

# 克隆仓库
git clone https://github.com/INQUIRELAB/mcp-bridge-api.git
cd mcp-bridge-api

# 安装依赖
npm install

# 启动服务
node index.js

客户端配置

创建一个 config.json 文件，内容如下：

{
  "servers": [
    {
      "name": "server1",
      "url": "http://localhost:3000",
      "protocol": "rest"
    },
    {
      "name": "server2",
      "url": "ws://localhost:3001",
      "protocol": "sse"
    }
  ],
  "timeout": 5000,
  "proxyEnabled": true
}

✨ 主要特性

• 多语言支持：支持 Node.js 和 Python 两种语言的开发，满足不同开发者的语言偏好。
• 协议兼容性：支持 STDIO、SSE（Server-Sent Events）等多种通信协议，增强了系统的通用性。
• 扩展插件系统：提供灵活的插件机制，便于功能扩展，如自定义协议处理、插件化日志记录等。
• 高可用性设计：内置负载均衡和容错机制，确保服务稳定运行，减少系统故障的影响。

📚 详细文档

项目概述

功能简介

• 提供统一的 REST API 接口，支持多种通信协议，为开发者提供一致的开发体验。
• 内置多语言处理能力，支持 Node.js 和 Python 开发，方便不同技术栈的开发者使用。
• 提供灵活的插件扩展机制，便于功能定制，满足多样化的业务需求。

技术架构

• 基于 Express 框架构建，性能高效稳定，确保系统能够处理高并发请求。
• 支持 WebSocket 协议，实现实时通信，适用于对实时性要求较高的场景。
• 提供完整的日志系统和监控面板，方便开发者对系统进行监控和维护。

核心组件

MCP Bridge Server

作为整个系统的中枢，负责处理来自客户端的请求，并将其转发到相应的 MCP 服务，确保请求的准确处理和转发。

Plugin System

允许用户根据需求扩展功能模块，例如：

• 自定义协议处理：满足特殊协议的处理需求。
• 插件化日志记录：方便对日志进行管理和分析。
• 扩展认证机制：增强系统的安全性。

风险级别说明

性能优化

负载均衡

使用 Nginx 实现负载均衡：

upstream mcp-servers {
    server server1:80;
    server server2:80;
}

server {
    listen 80;
    location / {
        proxy_pass http://mcp-servers;
    }
}

日志优化

启用 GELF 格式日志输出，便于集中化管理：

const winston = require('winston');
const graylog = new winston.transports.GELF({
    host: 'graylog.example.com',
    port: 12201
});

logger.add(graylog);

扩展阅读

• 官方文档
• 插件开发指南

贡献指南

欢迎社区贡献代码！请参考贡献规范。

💻 使用示例

基础用法

启动服务器

# 安装依赖
npm install express uuid

# 启动服务
node server.js

调用工具

使用 mcp-client 工具调用远程服务：

mcp-client --server http://localhost:3000 --command "echo Hello World"

查看日志

journalctl -u mcp-bridge-api -f

📄 许可证

本项目采用 MIT License，详细信息见 LICENSE 文件。