Treg：用一个令牌调用6000+工具端点
给代理团队用的工具路由层，一个令牌调用3000+端点，不必逐个注册供应商。
GitHub superdesigndev/treg 更新 2026-09-23 分支 main 星标 2.2K 分叉 218
Python Agent工具 OpenRouter FastAPI CLI 自托管

🧭 决策指南

为什么现在热： 无法从材料判断

适合，如果你

  • 你的代理要调用SEO、反向链接、社交或抓取等60+供应商工具。
    README 的开头说明提供“3,000+ catalogued endpoints across 60+ providers”，并列出SEO、backlinks、social和scraping。
  • 团队希望用一个X-Treg-Token共享供应商凭证，而不把密钥交给代理。
    README 的开头写明团队密钥可由每位队友的agent调用，credential不会离开server；后文说明请求携带X-Treg-Token。
  • 你使用Claude Code并希望通过插件安装treg，再执行treg mcp install。
    README 的“Or install it as a Claude Code plugin”章节提供/plugin marketplace add、/plugin install和treg mcp install流程。
  • 你需要自托管服务，并能提供tmux与uv运行本地FastAPI服务。
    README 的“Run it locally”章节要求tmux和uv，并提供scripts/dev-local.sh up；服务端依赖包括FastAPI。

不适合，如果你

  • 你只需要运行CLI去连接现有registry，却准备安装完整服务端依赖。
    README 明确说明pip install tools-registry只提供CLI；运行registry才需要tools-registry[server]。
  • 你的工具经常返回超过8MiB且需要settlement或ownership evidence。
    README 的“Architecture”章节说明这类大响应会返回502，且不会计费。
  • 你的上线评审要求公开、完整的生产部署拓扑和实时配置。
    README 说明官方生产拓扑和live settings维护在私有operator runbook中。
  • 你需要依赖正式版本号或release artifact进行锁定。
    项目元数据显示版本发布为0个，最新版本为“No releases”。

前置条件

  • 本地开发命令需要tmux与uv；README写明“One command (needs tmux + uv)”。
  • 服务端安装使用pip install "tools-registry[server]"，该extra增加FastAPI、数据库驱动和加密依赖。
  • 直接运行源码前需执行uv sync；README说明它从uv.lock创建虚拟环境并拉取开发服务端依赖。
  • 本地默认服务地址为http://localhost:18790；直接运行时监听0.0.0.0:18790。
  • 使用Claude Code插件时，README提供/plugin marketplace add superdesigndev/treg和/plugin install treg@treg。

第一步命令（README 原文）

curl -fsSL https://treg.to/install.sh | sh

要注意

  • Fish Audio语音输出是binary stdout，需重定向到speech.mp3文件。
    README 的Fish Audio示例写明Speech is binary stdout，并使用> speech.mp3。
  • strict_query工具会拒绝未声明、重复或不支持的query参数和请求体。
    README 的Quickstart后说明Catalog工具标记strict_query时会执行这些校验。
  • 服务端本地开发会使用独立SQLite库treg-dev.db和页面展示的邮箱OTP。
    README 的“Run it locally”章节明确写出own sqlite DB（treg-dev.db）和email OTP dev mode。
  • 自托管前要区分CLI包和server extra，否则只会得到treg命令。
    README 的Installing to run a server说明基础包是CLI only，服务端需安装tools-registry[server]。

材料未说明

  • README未给出3,000+端点的完整目录、各端点价格表或价格上限。
  • README未说明Render托管服务的SLA、配额、并发限制和数据保留策略。
  • README未提供私有operator runbook中的生产拓扑、部署步骤和高可用配置。
  • README未说明2,222颗星对应的实际活跃用户数、付费调用量或生产案例。
  • README未说明0个release背后的版本兼容策略、升级承诺和变更日志。
  • README未完整提供Teams、Configuration、Tests和License章节内容，无法据此判断团队权限、测试覆盖率和许可证细节。

💡 深度解析

6
适合 我需要把 Stripe、OpenAI 和 Resend 的密钥交给团队 Agent 使用，但不能让凭据离开服务器；Treg 的共享模型是否满足这个约束？
适合读者： 管理 Stripe、OpenAI 和 Resend 等团队密钥、希望让每位成员的 Agent 共享工具但不复制凭据的工程管理员

适合，因为 README 明确支持把团队密钥绑定到上游 URL，并让 Agent 只持有 Treg 令牌。

  • 共享流程使用 treg secret add STRIPE_KEY --value sk_live_123 和 treg add stripe --base-url https://api.stripe.com --secret STRIPE_KEY，说明密钥与代理目标可以分离管理。
  • treg upload env --select openai,stripe,resend 支持批量导入团队环境变量。
  • 通过代理请求时，Treg 会按主机解析工具、注入凭据，并在转发前剥离 X-Treg-Token；README 还明确说 key stays on the server。
  • treg tool ls 可查看团队共享工具，treg calls 可查看审计日志。

这适合共享凭据，但不等于完成企业权限治理。密钥轮换、成员离职回收、组织角色粒度和生产环境隔离仍需要核实。

  • README · 1. Endpoints: `treg secret add`, `treg add`, and `treg upload env`
  • README: “the key stays on the server, never in the skill”
  • README: “your `X-Treg-Token` is stripped before the upstream sees it”
  • README: “treg tool ls” and “treg calls”
treg upload env --select openai,stripe,resend     # or straight from the .env
材料未说明：README 摘选未说明组织角色、工具级权限和成员离职后的自动回收细节。；README 未说明密钥轮换是否会自动传播到所有绑定工具。
适合 我正在用 Claude Code 构建 Agent，不想为 SEO、社交趋势和网页抓取分别维护供应商账号；Treg 能否让我通过一个令牌完成工具发现和调用？
适合读者： 正在用 Claude Code 构建 Agent、希望通过一个令牌调用 SEO、社交趋势和网页抓取工具的 Superdesign 团队工程师

适合，因为 Treg 的统一入口正是为“工具而不是模型”的 Agent 调用设计的。

  • README 声称目录包含“3,000+ catalogued endpoints across 60+ providers”，覆盖 SEO、backlinks、social、trends 和 scraping。
  • 工具可以按任务搜索，例如 treg catalog search "backlinks for a domain"，不必预先知道供应商名称。
  • Claude Code 插件“Installs with no token and no configuration”，首次运行会引导登录并执行 treg mcp install。
  • 所有工具共用 X-Treg-Token，上游凭据由服务端注入，Agent 不需要接触底层密钥。

但目录中存在工具不代表每个上游都能稳定调用；供应商配额、账号状态和特殊认证仍可能阻断请求。

  • README: “3,000+ catalogued endpoints across 60+ providers”
  • README: “Ask for the task, not the tool”
  • README: “Or install it as a Claude Code plugin”
  • README: “Your token identifies you on every call (`X-Treg-Token` header)”
curl -fsSL https://treg.to/install.sh | sh
材料未说明：README 未给出每个目录工具的实时可用率、延迟和服务等级。；README 未说明 Claude Code 插件对所有工具参数的自动生成和错误恢复能力。
适合 我使用 Fish Audio S2.1 Pro，需要把语音结果写入 `speech.mp3`，同时还要处理严格查询参数；Treg CLI 是否适合这条自动化流水线？
适合读者： 需要处理 Fish Audio S2.1 Pro 语音生成、把二进制结果接入 CI 文件流水线的 Python 自动化工程师

适合，但前提是流水线明确把二进制 stdout 重定向到文件，并按目录定义构造请求。

  • README 给出了 Fish Audio S2.1 Pro 的完整调用示例，并使用 > speech.mp3 保存二进制语音；不重定向会污染终端或脚本输出。
  • 示例通过 --header model=s2.1-pro 和 JSON body 传入模型与文本，适合 CLI 自动化。
  • README 说明 strict_query 工具会拒绝未声明、重复或不支持的查询参数，以及不符合要求的请求体。
  • 调用前可用 treg catalog get 查看输入定义，资源则可用 treg resources list --provider fishaudio --kind voice 查询。

如果流水线依赖超大响应或跨供应商统一错误格式，README 没有证明 Treg 能提供一致行为；上游 Fish 账号限制仍然有效。

  • README Quickstart: “Speech is binary stdout, so redirect it to a file”
  • README Fish Audio example: `treg call fishaudio.tts.s2-1-pro ... > speech.mp3`
  • README: “Tools marked `strict_query` reject undeclared or repeated query parameters”
  • README: “Catalog tool inputs are described by `treg catalog get`”
treg call fishaudio.tts.s2-1-pro --method POST --header model=s2.1-pro \
  --data '{"text":"Hello from treg","format":"mp3"}' > speech.mp3
材料未说明：README 未说明 CLI 对非零退出码、重试和部分输出的具体处理方式。；README 未说明 Fish Audio 上游响应错误是否会被统一转换为稳定的机器可读格式。
适合 我需要把内部 SKILL.md、CLI 和 HTTP 工具作为团队能力发布，并让成员 Agent 按统一目录安装；Treg 是否覆盖注册、共享和使用这条链路？
适合读者： 需要把内部 SKILL.md、CLI 和 HTTP 工具统一发布给团队，并让成员 Agent 通过同一套目录安装的 Claude Code 平台维护者

适合，因为 Treg 把 skill、secret 和 tool 作为一个可共享的能力单元处理。

  • README 将 skill 定义为 SKILL.md recipe + its secrets + its tool(s)，可以一起注册，便于团队维护同一份能力定义。
  • treg upload skills --dir ~/.claude/skills --all 支持一次上传技能目录；成员可用 treg skill install seo-blog-writer 安装。
  • 安装后的 API 调用通过 Treg 令牌代理，README 明确说 key stays on the server，避免把密钥放进 skill。
  • Claude Code 插件安装后会加载 treg:treg skill，并引导 CLI 登录和 MCP 安装；这覆盖了 Agent 侧的接入路径。

如果内部 CLI 依赖复杂本地运行时、私有网络或非标准认证，Treg 的目录注册不一定解决部署和执行环境问题。

  • README · 3. Skills: “a skill is a whole capability (`SKILL.md` recipe + its secrets + its tool(s))”
  • README: `treg upload skills --dir ~/.claude/skills --all`
  • README: `treg skill install seo-blog-writer`
  • README: “the key stays on the server, never in the skill”
treg upload skills --dir ~/.claude/skills --all   # register a folder of skills in one pass
材料未说明：README 摘选未说明 Skill 版本、依赖锁定和回滚机制。；README 未说明团队成员安装私有 Skill 时的细粒度授权和审批流程。；README 未说明本地 CLI 执行失败时 Treg 是否负责环境安装或隔离。
视情况 我需要把 Treg 自托管在公司网络中，开发阶段使用 SQLite，并由 Python 团队维护 FastAPI 服务；项目是否提供足够的启动和服务器安装路径？
适合读者： 需要在公司网络内自托管注册中心、使用 SQLite 开发环境并由 Python 团队维护 FastAPI 服务的工程负责人

视情况：开发和小规模自托管路径较完整，但生产运维责任仍由你们承担。

  • README 提供 scripts/dev-local.sh up，会启动热重载服务、独立的 treg-dev.db 和开发用 OTP 模式。
  • 直接运行服务可使用 uv sync、uv run python -m treg upgrade 和 uv run python -m treg；项目语言分布中 Python 占绝大多数，适合 Python 团队接手。
  • 从包安装服务器必须使用 pip install "tools-registry[server]"；只安装基础包得到的只是 CLI。
  • 自托管必须生成并保护 TREG_SECRET_KEY，因为服务端集中保存加密凭据。

README 没有公开生产拓扑，官方生产配置位于私有 operator runbook，因此数据库高可用、备份、监控和升级流程不能仅靠公开文档确认。

  • README Part 2 · Self-hosting & development: `scripts/dev-local.sh up`
  • README: “its own sqlite DB (`treg-dev.db`)”
  • README: “install the server extra — `pip install "tools-registry[server]"`”
  • 项目洞察：凭据使用 Fernet 加密；自托管仍需运维数据库、密钥和监控
scripts/dev-local.sh up        # server on http://localhost:18790, dev-safe settings
材料未说明：README 未公开生产部署的数据库类型、扩展方式、备份策略和监控指标。；项目没有发布版本记录，升级兼容性和版本回滚流程未知。
视情况 我需要让 Agent 调用外部工具，但必须控制凭据和数据边界；Treg 的托管代理是否适合生产，还是必须自托管？
适合读者： 在有严格数据驻留和供应商合规要求的企业中，负责评估托管服务与自托管边界的安全架构师

视情况：Treg 能降低凭据传播风险，但不能单凭统一代理满足严格的数据驻留和合规要求。

  • 代理会在服务端保存并解密凭据后注入请求，Agent 只需统一令牌；这减少了凭据复制，却把高价值密钥集中到 Treg 服务端。
  • README 的官方托管服务是 treg.to，并写明 hosted service 运行在 Render；数据处理地点、留存周期和跨境路径没有在摘选中说明。
  • 项目支持任何人自托管，且提供 TREG_SECRET_KEY、SQLite 开发数据库和服务器安装路径，可把控制面放进自己的网络。
  • 项目数据将许可证标为 Other，没有发布版本记录；商业部署、再分发、升级承诺和审计材料不能按常见开源项目默认推断。

因此，普通内部自动化可以评估托管方案；涉及客户敏感数据、地域限制或强审计要求时，自托管仍需要完成独立合规审查。

  • 项目洞察：凭据在服务端保存和解密后注入，Agent 只需统一令牌
  • README: “Built for the Superdesign team, live at `treg.to`”
  • README: “anyone can self-host”
  • 项目数据：license 为 `Other`；latest_release 为空，release_count 为 0
uv run python -m treg keygen   # print a fresh Fernet key for TREG_SECRET_KEY
材料未说明：README 未说明托管服务的数据驻留区域、日志留存、加密边界和供应商分包情况。；README 未提供 SOC 2、ISO 27001、DPA 或其他合规证明。；README 未说明自托管版本是否与托管服务完全同步。

✨ 核心亮点

  • 覆盖60+供应商、3000+端点，按次计费
  • 统一X-Treg-Token，代理不接触供应商账号
  • 支持env、OAuth、CLI keychain四种注入
  • CLI、Claude Code插件与MCP可组合使用

🔧 工程化

  • 用treg catalog search按任务发现SEO、社交和抓取工具
  • treg call统一转发Fish Audio等供应商请求
  • OAuth自动刷新、健康探测并通知失效凭证所有者

⚠️ 风险

  • 基础pip包只有CLI，服务端需安装tools-registry[server]
  • 超过8MiB且需要结算证据的响应会返回502
  • 仓库没有版本发布，最新版本标为No releases
  • 生产拓扑在私有operator runbook中，公开材料不完整

👥 适合谁？

  • 需要让Python代理统一调用多供应商工具的团队
  • 使用Claude Code、MCP或CLI自动化的开发者
  • 需要共享团队密钥、OAuth和CLI凭证的组织