MCP协议桥接工具

一个基于stdio的Model Context Protocol (MCP)服务器,将Tollbit的动态工具箱桥接到基于stdio的MCP客户端,支持即插即用和云端动态工具。

  • by tollbit
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 tollbit/mcp-toolbox

使用说明

MCP工具箱

一个stdio模型上下文协议(MCP)服务器,将Tollbit的动态工具箱连接到基于stdio的MCP客户端。

为什么使用这个?

  • MCP客户端即插即用:适用于需要stdio MCP服务器的客户端(例如Claude Desktop)。
  • 来自云端的动态工具:工具通过Tollbit的后端获取和执行;无需在本地安装。
  • 简单安全:使用API密钥进行身份验证,并可选择使用 --toolbox-id.

安装

无需安装即可运行:

npx @tollbit/mcp-toolbox --api-key <your_api_key>

快速开始

  • 在本地运行网桥(任何MCP stdio客户端):
npx @tollbit/mcp-toolbox --api-key <your_api_key> [--toolbox-id <id>]

可选主机覆盖:

TB_MCP_HOST=https://mcp.tollbit.dev/ npx @tollbit/mcp-toolbox --api-key <your_api_key>
  • Claude Desktop(macOS)单行:
npx -y @tollbit/mcp-toolbox install_claude --api-key <your_api_key> [--toolbox-id <id>]

这增加了 @tollbit/mcp-toolbox 克劳德桌面的 claude_desktop_config.json 使用API密钥。

主要特点

  • Stdio MCP电桥 该代理 tools/list 和 tools/call 连接到Tollbit的动态服务器。
  • Claude安全工具名称:为了兼容性,将工具名称消毒为字母数字/下划线。
  • 流式HTTP传输 使用API密钥身份验证。
  • 保持活力,优雅关机 为了可靠性。
  • Claude Desktop的macOS安装程序 配置。

CLI选项

  • --api-key (必需):您的Tollbit API密钥(从开发人员门户获取)。
  • --toolbox-id (可选):要使用的工具箱的ID。默认为 mcp.

环境变量

  • TB_MCP_HOST (可选):动态MCP服务器的基本URL。违约: https://mcp.tollbit.dev/

文档

  • 全部文件: https://docs.tollbit.dev/quickstart/applications
  • api参考:请参阅模型上下文协议规范和中的代码 src/.
  • 例子:上述快速启动命令;文档中有更多示例。

常见用例

  • Claude桌面集成:使用快速添加动态MCP服务器 install_claude 脚本。
  • 自定义MCP客户端网桥:用作stdio服务器进程来访问Tollbit托管的工具。
  • 多工具箱工作流:切换上下文 --toolbox-id 以测试或瞄准不同的工具集。

需求

  • Node.js:18+推荐(ESM,顶级 import 支持)。
  • macOS:仅适用于 install_claude 辅助脚本。
  • Tollbit API密钥:从开发者门户网站获取https://hack.tollb.it/
  • 网络接入 向 TB_MCP_HOST (默认值 https://mcp.tollbit.dev/).

支持

  • 社区:加入我们的Discord:https://discord.gg/ZB4mEKDRm4
  • 问题:在GitHub上报告错误或请求功能问题:https://github.com/tollbit/mcp-toolbox/issues
  • 讨论:提问或分享想法:https://github.com/tollbit/mcp-toolbox/discussions

许可证

麻省理工学院