Skip to content
tool-bridge

文档首页

tool-bridge 是 HTBP（HTTP ToolBridge Protocol） 的参考实现。它把 MCP server、HTTP API、对象存储、本地机器与其他网关投影到一棵带权限、自描述的 HTTP 树上。

调用方只需要两样东西：

  • 一个指向网关的 BaseURL；
  • 一把只授予必要路径和动作的 Secret Key（SK）。

之后便可以沿路径发现能力、阅读契约、发起调用，而不必先安装某个专用 SDK，也不要求一定运行 MCP client。

从这里开始

Section titled “从这里开始”
  1. 用 5 分钟上手 在本机运行一个 Node/Docker 网关。
  2. 阅读核心心智模型，理解路径、节点、动作与运行时发现。
  3. 阅读设计原则，理解权限、密钥与联邦边界。
  4. 准备长期托管时，按 Cloudflare 部署创建边缘网关。

四件核心事情

Section titled “四件核心事情”
能力 解决的问题 主要入口
发现 当前身份真正能看见和调用什么？ ~help、~tree、~search
调用 如何用统一方式执行不同来源的工具？ HTTP、tb call、Dashboard、/~mcp
治理 哪把 SK 能对哪些路径执行哪些动作？ 路径 scope、deny 优先、不可见即 404
协作 如何复用经验与连接其他团队的能力？ ~feedback、remote federation

文档与运行时的分工

Section titled “文档与运行时的分工”

这份站点解释稳定的产品模型、部署方式与安全边界。它不会复制某个实例动态生成的完整工具目录。

当站点内容与正在运行的网关出现差异时，请按下面的优先级判断：

  1. 你正在访问的实例返回的 ~help、~tree 和 JSON Schema；
  2. 对应版本的 tool-bridge 源码与发布说明；
  3. 本站的概念与教程文档。

这样可以确保 Agent 依据当前身份、当前版本和当前配置做决定，而不是依赖一份可能过期的静态工具清单。