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 返回工具元数据（名称/描述/参数）和启用/禁用状态。
与AI代理（n8n等）一起使用
典型流程：
- 客服电话
/tools发现能力 - 代理选择工具
- 客服电话
/rpc带参数 - Bridge执行并返回结构化输出
看 docs/api.md 用于请求/响应示例。
烟雾测试UI
打开 smoke-test.html 在与网桥位于同一台机器上的浏览器中。
- 点击 检查健康
- 粘贴API密钥并单击 列出工具
码头工人
为了方便起见，我们提供了Docker支持。默认情况下，compose绑定到localhost。
如果更改绑定地址/端口，则表示更改了威胁模型。
维护理念
此项目跟踪 最新的 通过设计工具来保持最新状态。\ 如果你需要严格的可重复性，请在叉子上钉上版本。
许可证
麻省理工学院