← 返回目录

Trinity

社区

自主AI代理平台，支持Claude Code、Codex、Gemini代理，可自托管。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 95 / 438
Stars: ★ 639 非常热门
传输方式: Streamable HTTP
运行环境: Docker · Python 3.11+
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 8 天前
工具数: 77

62FMRS · C

Trinity是一个功能丰富的自托管AI代理编排平台。它提供广泛的MCP工具用于代理管理、调度、通信、监控和治理。适合生产环境使用，但需要Docker和自托管基础设施。MCP集成通过streamable-http提供，要求身份验证。

最强项 · 维护活跃度 15/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

12/20

维护活跃度

15/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 9/20: 证据：README 展示了一个包含后端(FastAPI)、前端(Vue)、MCP server (src/mcp-server, 90+ 工具)、调度器、Redis/SQLite/Vector 的完整 compose 架构；提供 install.sh、start.sh、quickstart.sh 等部署脚本；文档声称有测试指南(TESTING_GUIDE)和 CI 风格检查(validate-* 技能)。扣分：静态审查无法执行任何代码；未提供 CI 工作流文件或提交的测试套件路径作为可验证证据；MCP 工具清单只来自 README，缺少实际工具 schema；272 个未解决问题和复杂的多容器依赖(Docker、Redis、PostgreSQL、Vector、OTel)使干净启动和错误可控性存在明显不确定性。
安全与权限 12/20: 证据：README 明确说明 Docker 容器隔离、加密凭据存储(.credentials.enc)、RBAC 角色层级、追加式审计日志、HMAC webhook 签名、x402 支付确认流程、允许列表式邮箱访问控制、可配置 guardrails 以及 UnderDefense 渗透测试(等级 A)。SECURITY.md 的存在表明有漏洞披露渠道。扣分：未提供源码层面的验证(如实际的 RBAC 实现、审计日志仅追加的强制执行、密钥加密细节)；安装示例使用本地 localhost 和 Bearer 占位符，没有发现真实令牌；但需要持保留态度，因为文档声称的安全能力不能替代代码证据；远程部署/支付/SSH 访问等危险操作在 README 中缺少明确的确认步骤描述。
维护活跃度 15/20: 证据：许可证为 Apache-2.0；README 显示活跃发布节奏(v0.8.5, 2026-07-26)，有版本化发布说明、CLI 自动发布到 PyPI/Homebrew 的机制、CONTRIBUTING.md、SECURITY.md 以及指向 GitHub Issues/Discussions 的社区渠道。扣分：430 颗星与 272 个未解决问题比例偏高；没有可验证的提交历史/发布频率数据(README 不可信)；未提供依赖更新策略或安全公告实践的具体证据。
文档质量 14/20: 证据：README 是分层文档的入口：快速开始、手动安装、agent 模板、多 agent 系统 YAML、MCP 集成 JSON 示例、90+ 工具按类别列出、CLI 参考、部署指南、PostgreSQL 设置、已知问题、测试指南、安全证明书链接，以及面向 AI agent 的 AGENTS.md 路由。扣分：MCP 工具表缺少参数/输入 schema、错误码、速率限制等细节；仅从 README 声称 90+ 工具，但未提供实际工具定义文件证据；已知问题文档存在但未提供其内容；安装和认证步骤依赖文档中的声明，静态审查无法验证。
安装易用性 12/20: 证据：README 提供了多种安装路径：一键 curl 脚本、手动 Docker 步骤、交互式 quickstart.sh、CLI(pip/brew)、Claude Code 插件市场，以及 MCP 客户端 JSON 配置示例(streamable-http, localhost:8080/mcp, Bearer)。要求仅 Docker + API key。扣分：未提供 CI 工作流或提交的测试套件作为已验证执行证据，因此静态校准将 setup 上限设为 15；多容器依赖(Docker Compose, Redis, PostgreSQL, Vector, OTel)和可选子模块使安装可能脆弱；缺少对非 Linux 平台(Windows)的支持说明；MCP 连接后的端到端验证步骤描述不足。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络连接数据库

适合谁

需要在内部部署AI代理并强调数据驻留和审计的组织。
希望使用Claude Code、Codex或Gemini运行代理的开发团队。
需要隔离、调度和可观测性的生产级代理编排。

不适合谁

需要零配置托管解决方案的用户（需要Docker和自托管）。
寻求无需Docker的轻量级代理框架的人。
对拥有平台管理不感兴趣的团队。

所需权限

MCP服务器需要API密钥（Bearer token）进行身份验证。
代理本身在Docker容器内运行，可能需要网络访问API和外部端点。
平台存储凭据（加密）和Git数据。
管理员和用户通过角色层次结构（admin、creator、operator、user）控制访问。

风险与副作用

自托管需要基础设施管理，错误配置可能导致安全问题。
代理运行的代码可能不受信任；Docker隔离是重要的缓解措施。
通过Git存储凭据，加密但需要适当保护。
Webhook可能暴露公共端点，缓解措施包括HMAC签名。

安装接入

准备工作

运行环境：Docker · Python 3.11+

SECRET_KEY 必填密钥 JWT 签名密钥，可用 openssl rand -hex 32 生成。

ADMIN_PASSWORD 必填密钥管理员登录密码，至少 8 个字符。

ANTHROPIC_API_KEY 可选密钥 Anthropic API 密钥，用于 Claude 驱动的 agent，可在 Settings UI 中配置。

GITHUB_PAT 可选密钥 GitHub 个人访问令牌，用于克隆私有模板仓库。

其他可选配置项（4 个）

DATABASE_URL 可选可选的 PostgreSQL 连接串，生产环境推荐；不设置则默认使用 SQLite。

OTEL_ENABLED 可选是否启用 OpenTelemetry 指标导出，默认 false。

EMAIL_PROVIDER 可选邮箱验证码提供方：console（开发）、smtp、sendgrid 或 resend。

EXTRA_CORS_ORIGINS 可选额外的 CORS 允许来源。

克隆仓库: git clone https://github.com/abilityai/trinity.git && cd trinity
复制 .env.example 到 .env 并设置 SECRET_KEY (openssl rand -hex 32) 和 ADMIN_PASSWORD。
运行 ./scripts/deploy/build-base-image.sh 构建基础镜像。
运行 ./scripts/deploy/start.sh 启动所有服务。
打开 http://localhost 完成设置向导，设置管理员密码并配置API密钥。
在MCP客户端配置 'mcpServers' 指向 http://localhost:8080/mcp，使用 'Authorization: Bearer YOUR_API_KEY' 头。

claude_desktop_config.json

{
  "mcpServers": {
    "trinity": {
      "type": "streamable-http",
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "trinity": {
      "type": "streamable-http",
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add --transport http trinity http://localhost:8080/mcp --header 'Authorization: Bearer YOUR_API_KEY'

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

部署完成后在 MCP 客户端中连接 http://localhost:8080/mcp，工具列表应出现 list_agents、chat_with_agent 等工具；调用 list_agents 返回 agent 列表即说明连接成功。

常见排障

确保Docker守护进程正在运行，并且你具有权限。
检查后端日志: docker compose logs -f backend。
验证 .env 中的 SECRET_KEY 和 ADMIN_PASSWORD 已设置。
确保端口80、8000、8080未占用。
测试MCP连接：curl http://localhost:8080/mcp。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出所有 agent 及其运行状态
给我的 my-agent 发一条消息，问它现在能做什么
为 my-agent 创建一个每天早上九点执行的任务计划
查看 my-agent 最近的容器日志

工具能力 77

list_agents 只读

列出所有代理及其状态。

get_agent 只读

获取详细代理信息。

get_agent_info 只读

获取代理模板元数据（能力、命令等）。

create_agent 写入

从模板创建新代理。

deploy_local_agent 写入

打包并部署本地代理目录。

start_agent 写入

启动代理容器。

stop_agent 写入

停止代理容器。

rename_agent 写入

重命名代理。

展开其余 69 个工具

delete_agent 破坏性

删除代理。

initialize_github_sync 写入

初始化GitHub同步。

set_agent_github_pat 写入

设置每个代理的GitHub PAT。

chat_with_agent 写入

向代理发送消息并获取响应（支持并行和异步模式）。

get_chat_history 只读

检索对话历史。

get_agent_logs 只读

查看容器日志。

fan_out 写入

向代理分发N个并行任务并收集结果。

send_message 写入

通过已验证的电子邮件主动发送用户消息（代理发起）。

send_group_message 写入

主动发送群组消息。

list_channel_groups 只读

列出频道组。

deploy_system 写入

从YAML清单部署多代理系统。

list_systems 只读

列出已部署系统及其代理计数。

restart_system 写入

重启系统中的所有代理。

get_system_manifest 只读

导出系统配置为YAML。

list_templates 只读

列出可用模板。

inject_credentials 写入

直接向代理注入凭据文件。

get_credential_status 只读

检查凭据文件。

get_agent_ssh_access 写入

生成临时SSH凭据以直接访问终端。

list_schedules 只读

列出所有计划。

create_schedule 写入

创建新计划。

update_schedule 写入

更新计划。

delete_schedule 破坏性

删除计划。

enable_schedule 写入

启用计划。

disable_schedule 写入

禁用计划。

trigger_schedule 写入

手动触发计划。

list_executions 只读

列出最近的执行。

poll_async_result 只读

轮询异步结果。

get_agent_activity 只读

获取代理活动摘要。

list_tags 只读

列出所有代理标签。

get_tag 只读

获取标签。

set_tag 写入

设置标签。

add_agent_tag 写入

为代理添加标签。

remove_agent_tag 写入

从代理移除标签。

list_subscriptions 只读

列出订阅。

register_subscription 写入

注册Claude Max/Pro订阅。

assign_subscription 写入

将订阅分配给代理。

unassign_subscription 写入

取消分配订阅。

list_skills 只读

列出技能。

create_skill 写入

创建技能。

update_skill 写入

更新技能。

delete_skill 破坏性

删除技能。

assign_skill 写入

将技能分配给代理。

get_fleet_health 只读

获取舰队健康状态。

get_agent_health 只读

获取代理健康详情。

trigger_health_check 写入

触发健康检查。

configure_payments 写入

配置Nevermined x402支付。

toggle_payment 写入

切换支付。

view_payment_history 只读

查看支付历史。

send_notification 写入

从代理向平台发送结构化通知。

emit_event 写入

发出事件。

subscribe_to_events 写入

订阅代理事件。

list_event_subscriptions 只读

列出事件订阅。

delete_event_subscription 破坏性

删除事件订阅。

git_status 只读

获取Git状态。

git_sync 写入

同步Git。

git_log 只读

获取Git日志。

git_pull 写入

拉取Git更改。

git_sync_state 只读

获取同步状态。

git_recovery_reset 破坏性

恢复重置。

list_operator_queue 只读

读取人机循环审批项目。

respond_to_approval 写入

响应审批项目。

run_loop 写入

运行有界顺序任务循环。

monitor_loop 只读

监控循环。

stop_loop 写入

停止循环。

publish_report 写入

发布结构化代理报告到仪表板。

write_memory 写入

为频道会话写入每用户记忆。

list_pipelines 只读

检查代理定义的长运行管道。

inspect_pipeline 只读

检查管道。

make_phone_call 破坏性

发起可选呼出电话。

使用场景

在自有基础设施上部署自主AI代理，实现治理和审计。

管理多个代理的舰队，包括调度、委派和监控。

将Claude Code编写的代理部署到生产环境。

从单个YAML清单协调多代理系统。

支持客户端

Claude Desktop

Claude Code

依据项目文档列出，未经本站实测。

详细介绍

Trinity是一个自主AI代理平台，允许你在自己的基础设施上构建和运行专有系统。每个代理在自己的隔离Docker容器中运行，提供实时可观测性、车队调度、代理间委派和防篡改审计跟踪。支持多个运行时：Claude Code（Anthropic）、OpenAI Codex和Gemini CLI（Google）。平台包括一个Vue.js前端、FastAPI后端和一个MCP服务器（端口8080），暴露90多个工具用于外部编排。