Tetrees MCP

Tetrees Agent EX

用于通过托管式 Tetrees Agent MCP 和 API 使用、培养、购买和发布 Tetrees AI Packs 的公共集成工具包。

[](https://mcpqueen.com/s/ai.tetrees.ex/mcp)

探索 Tetrees AI Packs  ·  通过 MCP 连接  ·  发布 AI Pack

此仓库是公开的 @tetrees/mcp 产品（ai.tetrees/mcp）：stdio MCP 服务、客户端、配置示例和安全扩展示例。它不包含 Tetrees Agent 内部实现、私有 Pack 智能、Agent AVCP 评分、服务提示词、存储、内容审核或交易基础设施。

可以构建什么

路径	使用此工具包可以
买家／运营者	搜索 Packs、查看公开的 Agent AVCP 报告、估算运行费用、使用 Tetrees Points 试用 Pack、获取免费 Pack，以及下载已拥有的 .taip 版本。
构建者	将经过试用的 Pack 连接到用户自有的 HTTPS API、嵌套 MCP 服务或无需 shell 的本地技能，同时让凭据保留在本地。
卖家	创建商品列表、上传不可变的 .taip 版本和图片、查看就绪状态、运行 Agent AVCP、阅读私有修复反馈，并发布通过验证的版本。

Tetrees 托管的工作不需要本地 GPU。由模型提供支持的运行会在执行前以 Tetrees Points 报价；已拥有的 Pack 也可以使用提供给本地 MCP 进程的受支持提供商密钥。

快速开始：托管式 MCP

要求：Node.js 20+，以及从 Tetrees Account 获取的可撤销 API 令牌。

将以下内容添加到 MCP 客户端的配置中：

{
  "mcpServers": {
    "tetrees-ai": {
      "command": "npx",
      "args": ["-y", "https://ex.tetrees.ai/pkg/tetrees-mcp.tgz?v=2.2.1"],
      "env": {
        "TETREES_API_URL": "https://ex.tetrees.ai/api",
        "TETREES_TOKEN": "<revocable-account-token>"
      }
    }
  }
}

重启 MCP 客户端，然后让它：

Search Tetrees AI Packs for repository issue triage. Show the public Agent AVCP
report and runtime profile for the best match, then quote an 8k/2k Point-funded
run. Do not run it until I approve the quoted maximum.

请勿将提供商密钥放入 Pack、提示词、源文件或共享 MCP 配置中。可选的 BYOK 密钥只能放在本地 MCP 进程环境中。参见 examples/mcp/mcp-config.jsonc。

检查 MCP 合约

npm install
export TETREES_TOKEN="txk_..."
npm run mcp:inspect

检查器会启动官方托管 MCP 包，列出其公开工具和资源，检查预期的买家／构建者／卖家功能范围，并在不消耗 Points 或更改账户状态的情况下退出。

v=2.2.1 后缀是有意设置的：它可防止 npx 重用缓存在同一 URL 下的旧 MCP tarball。仅当 Tetrees 发布了更新的 MCP 合约时才更改它。同一包在 npm 上的标识为 @tetrees/[email protected]。

公共 API 命令行工具

将 .env.example 中的值复制到 shell 环境中；本项目有意不自动加载机密文件。

export TETREES_TOKEN="txk_..."

# Read-only calls
npm run tetrees -- status
npm run tetrees -- catalog "research"
npm run tetrees -- models
npm run tetrees -- skills
npm run tetrees -- owned
npm run tetrees -- runtime <pack-id>
npm run tetrees -- report <pack-id>

# Quote first. This never starts a model request.
npm run tetrees -- quote <pack-id> <model-id>

# A Point-spending run needs the exact confirmation flag.
npm run tetrees -- run <pack-id> <model-id> "Your task" --confirm-spend

此命令行工具会对响应中看似机密的字段进行脱敏，并报告 Tetrees 错误代码、HTTP 状态和 Retry-After。它不会自动重试更改操作。

买家流程

1. 搜索 Pack。
2. 查看其公开的 Agent AVCP 报告和运行时配置。
3. 估算确切的模型、令牌上限、托管技能和成长检查点。
4. 运行由 Points 付费的无状态预览。未使用的预留 Points 会退还。
5. 在 Tetrees EX 获取免费 Pack 或购买付费 Pack。
6. 获得所有权后即可下载、使用 BYOK、保存成长状态并扩展客户端。

运行文档中的只读示例：

node examples/buyer/discover-and-quote.mjs "incident response"

构建者流程：添加功能，但不将其提供给 Tetrees

已发布的 Pack 可以声明通过 Agent AVCP 的客户端扩展。实际绑定和凭据仍保留在用户的计算机上。

支持的绑定模式：

• https_api：固定的 HTTPS 基础 URL、声明的方法，以及由环境变量提供的标头。
• mcp：启动时不使用 shell 的嵌套 MCP 服务，并映射到声明的工具名称。
• local_skill：接收一个 JSON 请求并返回一个 JSON 结果的无 shell 子进程。

请从以下内容开始：

• examples/extensions/client-extensions.example.json
• examples/extensions/local-skill/issue-summary.mjs
• docs/BUILDER_GUIDE.md

Tetrees 托管服务不会继承这些本地权限。写入方法需要每次调用都提供确切短语 APPROVE extensionId.methodId。

卖家流程

受支持的发布者路径有意采用契约驱动：

# Read-only readiness/report inspection
node examples/seller/check-readiness.mjs <pack-id>

# Upload one higher immutable version. Requires explicit confirmation.
node examples/seller/upload-pack.mjs <pack-id> 1.1.0 ./release.taip --confirm-upload

然后使用托管 MCP 工具或 Tetrees API 参考提交、获取 Agent AVCP 报价、确认确切的 Point 数量后运行、查看私密报告，并且仅发布通过验证的摘要。

请参阅 docs/SELLER_GUIDE.md 和 examples/seller/pack-listing.example.json。

稳定的公共参考资料

• MCP 指南
• API 文档
• OpenAPI 3.1
• Postman 集合
• AI Pack 目录

安全与产品边界

此代码库不包含：

• Tetrees Agent 实现、私密 Pack 内容、记忆表示或成长逻辑；
• Agent AVCP 评分规则、内部评估样例、服务提示词或审核逻辑；
• 模型提供商凭据、定价利润、签名密钥、存储详情、数据库、管理 API、部署代码或生产配置。

这些示例仅通过文档说明的、经过身份验证的公共契约运行。贡献前请查看 SECURITY.md 和 docs/PUBLIC_BOUNDARY.md。

验证此代码库

npm test
npm run check:public-boundary
npm pack --dry-run

许可证

此代码库中的客户端示例和文档采用 MIT 许可证。Tetrees、Tetrees Agent、Tetrees AI Pack、TAIP 和 Agent AVCP 的名称及服务标志仍归 Tetrees EX 所有。此许可证不授予对托管服务或私密 Pack 智能内容的访问权限或相关权利。