AI导哈

HTTP/JSON-RPC桥接工具

NamelyCorp MCP Bridge是一个本地优先、可扩展的HTTP/JSON-RPC桥接工具，用于安全地暴露和控制系统工具，供AI代理和自动化平台使用。

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

使用说明

NamelyCorp MCP桥

这 NamelyCorp MCP桥 是一个本地优先、可扩展的HTTP/JSON-RPC桥，它公开了来自一个系统的工具，以便它们可以被另一个系统安全地访问和控制，包括人工智能代理和自动化平台，如 n8n.

该项目旨在作为 能力桥，而不是云服务。

这是什么

  • 始终如一 API表面 用于公开本地/系统工具
  • 在原本断开的系统之间的桥梁层
  • 一种模式 工具发现、执行和控制
  • 可扩展：添加新工具并使其可由代理立即调用

这不是什么

  • 不是托管SaaS
  • 不是面向公众的API
  • 不是交钥匙安全产品
  • 不是不受信任用户的沙盒

安全模型

这座桥可以很强大。它与 防御性违约:

  • 绑定到 127.0.0.1 默认情况下
  • API密钥验证 默认情况下需要
  • 命令执行 默认情况下禁用
  • 除非明确配置，否则禁用CORS
  • 工具可以通过以下方式进行内省 /tools

请勿将此服务直接暴露于公共互联网。 如果你这样做，你要对后果负责。

快速入门（本地）

需求

  • Node.js 18+
  • npm

设置

git clone https://github.com/NamelyCorp/namelycorp-mcp-bridge.git
cd namelycorp-mcp-bridge
cp .env.example .env

编辑 .env 并且至少设置：

MCP_API_KEY=your-long-random-key

跑

npm install
npm start

验证

curl http://127.0.0.1:3333/health

工具发现

GET /tools
Authorization: Bearer <MCP_API_KEY>

返回工具元数据（名称/描述/参数）和启用/禁用状态。

与AI代理（n8n等）一起使用

典型流程：

  1. 客服电话 /tools 发现能力
  2. 代理选择工具
  3. 客服电话 /rpc 带参数
  4. Bridge执行并返回结构化输出

看 docs/api.md 用于请求/响应示例。

烟雾测试UI

打开 smoke-test.html 在与网桥位于同一台机器上的浏览器中。

  • 点击 检查健康
  • 粘贴API密钥并单击 列出工具

码头工人

为了方便起见，我们提供了Docker支持。默认情况下，compose绑定到localhost。

如果更改绑定地址/端口，则表示更改了威胁模型。

维护理念

此项目跟踪 最新的 通过设计工具来保持最新状态。
如果你需要严格的可重复性，请在叉子上钉上版本。

许可证

麻省理工学院

相关 MCP