OPEN SOURCE · SELF-HOSTED · AGENT READY
UNIVERSAL CAPABILITY LAYER FOR AGENTS
tool-bridge 把 MCP、HTTP API、上下文、设备与远端网关组织成一个统一入口。Agent 在运行时发现能力、读取契约，并在身份边界内完成调用。
AGENT ENVIRONMENTS
REAL CAPABILITIES
POST /system/status/getDEMO跨环境统一入口
契约来自运行实例
能力随身份可见
同一语义，多种入口
运行在哪里，都能接入
BUILT FOR REAL WORK
发现、调用、交付与管理。把 Agent 的一次尝试，变成可以持续运行的工作方式。
YOUR DAILY WORKSPACE
搜索工具、收藏常用能力、回到最近调用。添加工具后，沿授权与首次使用的引导继续；目录和管理任务各有清晰入口。
探索新版 Dashboard↗常用工具☆
最近使用
DURABLE DEVICE DELIVERY
显式选择持久投递，由设备上线后主动领取。跟踪任务状态与执行回执，让远端调用拥有可追溯的结果。
~delivery: mailbox了解设备离线投递↗CONTEXT THAT PERSISTS
通过默认 Store 管理对象与上传，用平台 Context 组织资料。元数据留在 PostgreSQL，文件字节进入 S3 兼容存储。
01 / ONE BRIDGE, EVERY RUNTIME
模型会变化，运行时会迁移，工具也会不断增加。把能力层独立出来，Agent 才能在不同环境中持续工作，而不是反复重做集成。
Agent 产品团队
Agent 从目标实例读取当前可见的工具、参数和使用说明。上下文更轻，调用边界更清晰。
平台与安全团队
MCP、HTTP、对象存储与本地设备共享路径和动作权限；真实密钥始终留在各自的 SecretStore。
工具与服务提供方
继续维护 MCP Server、REST API 或 Plugin。tool-bridge 负责投影、发现、授权和跨入口的一致语义。
02 / RUNTIME-NATIVE
Agent 沿一个稳定循环工作：发现当前身份可见的路径，读取运行时契约，再调用同一路径。能力变化时，不必重新发布客户端。
illustrative sessiontb tree --depth 2/
├── tools/
│ ├── github/
│ └── linear/
├── ctx/
│ └── briefs/
└── system/
└── statusscope applied不可见路径不会进入结果。
tb help system/status/get --json# system/status/get
Gateway health and summary.
{}readhealthy · version · nodeCountruntime truthMarkdown、Help DSL 与 JSON 来自同一运行实例。
tb call system/status/get{
"healthy": true,
"version": "<runtime version>",
"nodeCount": 12
}200 · allowed调用者 SK 不会被透传给上游。
~help 和 JSON Schema 随路径、身份与已挂载能力生成。
发现与调用经过同一判断；无权路径不会泄露存在性。
HTTP、CLI、Dashboard 与 MCP 共享同一棵树和节点语义。
03 / BEYOND PROTOCOL ADAPTERS
普通适配器解决“怎么调用”。tool-bridge 继续回答：当前身份能看到什么、契约从哪里来、谁可以调用，以及凭证如何与调用者隔离。
理解产品模型↗04 / SECURITY IS STRUCTURAL
每次发现与调用都带着身份进入同一棵树。配置可以被管理，真实凭证留在 SecretStore；provider 与 remote 使用独立的出站身份。
阅读安全边界↗tools/github/issuescall allow200tools/github/adminread deny404device/macbookregister no scope404被拒绝的路径不会透露节点是否存在。
allow 与 deny 同时匹配时，deny 永远优先。
节点只保存 authRef，不回显真实凭证。
调用者 SK 不会被透传给 provider 或 remote。
05 / RUN IT YOUR WAY
从自己的机器开始，运行 Node、PostgreSQL 与 S3 完整栈。需要扩展时，再走向 Kubernetes 或嵌入自己的应用。
START HERE
Node 应用、PostgreSQL 与 S3 兼容对象服务组成完整栈；无需手填 .env，通过本机配对完成首次安装。
$ docker compose up -d
克隆仓库后执行持久保存数据卷启动后完成本机配对
GROW WITH YOUR TEAM
Helm 部署同一套 Node 服务，连接外部 PostgreSQL 与 S3。多副本共享已初始化的 bootstrap，并通过 Redis 路由实时设备调用。
$ helm show values ./deploy/helm/tool-bridge
先检查 chart 配置配对初始化配置 readiness
BUILD YOUR OWN
Node SDK 根入口嵌入应用；client、store、device 子入口供不同运行时消费。宿主显式注入存储与领域仓库。
$ import { createToolBridge } from '@tool-bridge/sdk'
注入宿主依赖显式提供领域仓库挂载你的 provider
还不确定？ 比较全部部署路径↗
06 / DOCUMENTATION
跑通第一个闭环、接入现有能力、部署生产环境，或建立安全治理。每条路径都从真实任务开始。
浏览全部文档↗启动、登录、发现并完成一次真实调用。
复用现有 MCP、HTTP API、设备与存储。
选择宿主，建立生产验收与恢复能力。
最小权限、密钥隔离、反馈与故障诊断。
BUILD BEYOND THE DEMO
下一代软件不会把 Agent 困在单一环境里。先接通一个真实能力，再把边界一步步推远。