使用说明
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
许可证
麻省理工学院
