+ 发布产品

tool-bridge Skill 技能

统一管理 Agent 工具调用、上下文与设备的开源基础设施

AI Agent
查看 Skill ↗
认领产品

tool-bridge 是什么

tool-bridge 是 HTBP（HTTP ToolBridge Protocol）的参考实现，旨在解决 AI Agent 在实际生产环境中面临的工具碎片化问题。它将分散在 MCP Server、HTTP API、对象存储、本地机器中的所有能力，统一组织到一棵带权限的、自描述的 HTTP 能力树中，让 Agent 只需一个 BaseURL 和一个 Secret Key，就能发现能力、阅读契约并发起调用，无需安装特定 SDK。

核心能力

  • 统一能力树协议：基于树形结构组织所有工具、上下文、设备和远端服务，每级路径都有 ~help 语义提供文档和参数 Schema
  • 多协议兼容 MCP：兼容 MCP 协议，支持接入外部 MCP Server，也支持以 MCP 方式暴露自身能力
  • SDK 与 CLI 双重接入：提供 npm @tool-bridge/sdk 和 @tool-bridge/cli，支持 Docker Compose 一键部署
  • 细粒度权限控制：Secret Key 按路径和动作授权，deny 优先，实现零信任安全
  • 设备管理：支持 Linux / macOS / Windows 的 Shell/Daemon 接入，以及 iOS / Android 的通知、信箱、震动、摄像头调用
  • 移动端 App：提供 Android App，内置信箱页查看 Agent 报告和设备连接状态
  • 浏览器 Dashboard：无需安装桌面客户端，直接通过浏览器管理工具、浏览能力树、查看设备状态
  • 反馈机制：Agent 可以在具体路径留下使用反馈，供后续调用参考，实现知识积累
  • 反向注册与联邦：支持工具反向注册，允许将另一套 HTBP 服务联邦为当前树的子树

安装配置

方式一：Docker Compose 本地部署

  1. 克隆仓库：
    git clone https://github.com/TokenRollAI/tool-bridge.git
cd tool-bridge
docker compose up -d --build
  2. 初始化管理员：
    docker compose exec -T app node /app/dist/admin.js pair
  3. 打开 http://127.0.0.1:8787/ui/setup 完成安装配置

方式二：CLI 快速接入

npm install -g @tool-bridge/cli
tb login --base-url http://127.0.0.1:8787
tb tree --depth 2
tb call system/status/get

方式三：安装 Agent Skill

px skills add TokenRollAI/tool-bridge-skill

使用步骤

  1. 部署或连接网关：本地 Docker 部署或连接远程 tool-bridge 实例
  2. 配置访问密钥：在 Dashboard 创建按路径和动作限制的 SK，分配给 Agent
  3. 添加工具：选择 MCP Server、HTTP 端点或内置集成
  4. Agent 调用：通过 Skill 或直接 HTTP 请求发现能力并调用工具
  5. 查看反馈：通过 ~feedback 接口查看各路径的历史调用经验

适用场景

  • 企业内部 Agent 平台统一管理
  • Agent 与线上服务器、Pod 联动
  • 多团队能力共享与联邦
  • MCP 生态整合与自部署
  • 工具调用治理与审计

适用人群

  • AI Infra 工程师：搭建统一的 Agent 工具管理和调用平台
  • Agent 开发者：统一管理多种 Agent 工具的任务和上下文
  • 平台工程师：管理企业内部 AI 平台，实现细粒度权限控制
  • DevOps 团队：让 Agent 直接操作线上服务，减少人工介入

工作原理

tool-bridge 基于 HTTP 树状结构组织资源和能力。每个叶子节点代表一个可调用工具或信息路径，节点自带 ~help、~tree、~search、~feedback 等元命令。Agent 只需知道 BaseURL 和 SK，通过标准 HTTP GET 发现能力、POST 调用工具，无须专用 SDK。权限模型通过 SK 作用域实现最小权限原则。

官方链接

团队信息

AI产品库 官方
由 AI 猎手自动发现

评论与建议

0 条评论