AI导哈

API转换工具

MCP Bridge帮助团队将现有的HTTP操作转换为结构化的、本地优先的MCP工具，供Claude Desktop、Cursor、Zed等MCP客户端安全调用。

  • by ainativeera
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ainativeera/mcp-bridge

使用说明

MCP Bridge

Turn internal APIs and cURL workflows into local MCP tools for AI agents.

MCP Bridge helps teams convert existing HTTP operations into structured, local-first MCP tools that Claude Desktop, Cursor, Zed, and other MCP clients can safely call.

English · 简体中文

GitHub · Getting Started · MCP Config · Contributing · Security

MCP Bridge专为现实世界的办公自动化场景而设计，在这些场景中，团队已经拥有可工作的cURL命令，并希望将其转换为更安全、可重用和对代理友好的工具，而无需从头开始重建集成。

为什么选择MCP桥

  • 导入现有的cURL命令，而不是从头开始重建集成
  • 定义MCP友好的参数模式和响应描述
  • 为桌面AI客户端运行本地MCP SSE服务器
  • 在将工具暴露给代理之前，对其进行测试、调试和迭代
  • 将体验打包为面向非技术用户的桌面应用程序

核心能力

  • cURL导入：将常见请求形状解析为可编辑的MCP工具
  • 工具编辑器：配置方法、URL、标题、正文、参数和输出字段
  • 响应整形：提取大型JSON响应的有用部分
  • 本地持久性：在SQLite中存储工具和日志
  • MCP传输：通过本地SSE端点公开工具
  • 桌面打包：作为适用于macOS和Windows的Electron应用程序发货

用例

  • 将内部审批或CRM API转化为可调用的代理工具
  • 将重复的办公工作流程包裹在稳定的MCP操作之后
  • 原型代理与现有API快速集成
  • 让AI助手安全、结构化地访问业务运营

截图

cURL到MCP工作流

本地MCP配置

建筑

React UI
  -> Electron desktop shell
  -> Local Express server
  -> SQLite storage
  -> MCP SSE endpoint
  -> External APIs imported from cURL definitions

关键切入点：

  • src/App.tsx：主应用程序UI
  • server.ts：本地Express服务器和MCP SSE实施
  • electron-main.ts：电子主流程和桌面桥
  • src/db.ts：SQLite持久层

入门指南

先决条件

  • Node.js 20或更新版本
  • 建议使用npm 10或更新版本
  • macOS for mac桌面打包
  • 用于本机Windows验证的Windows，或支持Electron Builder交叉打包的macOS

安装

npm install

运行Web应用程序

npm run dev

打开：

http://localhost:3000

在开发中运行桌面应用程序

npm run electron:dev

构建

npm run build

创建桌面软件包

npm run dist:mac
npm run dist:win

质量检查

npm run check

环境变量

复制 .env.example 到 .env 并根据需要进行调整。

重要价值观：

  • PORT：本地HTTP和SSE端口
  • NODE_ENV：开发或生产
  • DB_PATH：SQLite数据库位置
  • API_KEY：用于保护本地MCP访问的可选API密钥
  • RATE_LIMIT_WINDOW_MS：API速率限制窗口
  • RATE_LIMIT_MAX_REQUESTS：窗口中允许的最大请求数
  • CORS_ORIGINS：逗号分隔的起源
  • LOG_LEVEL：记录员冗长

MCP端点

当服务器在本地运行时，SSE端点为：

http://localhost:3000/sse

在打包的桌面应用程序中，UI会显示检测到的本地网络地址，以便在同一局域网上的设备之间更容易进行客户端设置。

建议的MCP客户端配置

{
  "mcpServers": {
    "mcp-bridge": {
      "url": "http://localhost:3000/sse"
    }
  }
}

如果启用API密钥：

{
  "mcpServers": {
    "mcp-bridge": {
      "url": "http://localhost:3000/sse",
      "headers": {
        "X-API-Key": "your-secret-api-key"
      }
    }
  }
}

路线图

  • 高风险工具更安全的写入操作确认
  • 为API密钥、cookie和OAuth-style流提供更好的身份验证模板
  • 更强大的cURL解析覆盖率
  • 具有验证和风险级别的工具发布工作流程
  • 更丰富的审计日志、回放和可观察性
  • 办公SaaS产品的可重用连接器模板

贡献

欢迎捐款。从这里开始：

社区标准

  • 保持尊重和建设性
  • 更喜欢小而集中的拉取请求
  • 包括bug的复制步骤
  • 在提出功能时，请记住办公自动化和代理安全

许可证

该项目根据MIT许可证获得许可。看 许可证.

相关 MCP