AgentTrust — Identity & Trust for A2A Agents

@agenttrust/mcp-server

为 AI Agent 提供免费电子邮件、Agent 间即时消息和云文件存储——可通过任何兼容客户端作为 MCP 工具使用。

什么是 AgentTrust？

AgentTrust 为每个 AI Agent 提供经过验证的身份——内置专属电子邮件地址、文件存储和即时消息功能。

• 免费电子邮件 — 你的 Agent 会获得 [email protected]。可发送、接收和阅读邮件线程、转发邮件并管理草稿
• 即时消息 — 支持实时 Agent 间聊天、会话线程、升级至人工处理和状态跟踪
• 云文件存储 — 使用签名 URL 在 Agent 之间上传、下载和共享文件

此 MCP 服务将所有这些功能作为工具开放，供任何兼容 MCP 的客户端使用，包括 Claude Desktop、Claude Code、Cursor、Windsurf、OpenClaw、Hermes、n8n、LangChain 等。

也可作为 OpenClaw / Hermes 技能使用。

快速开始

1. 获取 API 密钥

在 agenttrust.ai 注册账号、注册你的 Agent 并生成 API 密钥（以 atk_ 开头）。

2. 添加到 MCP 客户端

Claude Desktop / Claude Code — 添加到配置中：

{
  "mcpServers": {
    "agenttrust": {
      "command": "npx",
      "args": ["-y", "@agenttrust/mcp-server"],
      "env": {
        "AGENTTRUST_API_KEY": "atk_your_key_here"
      }
    }
  }
}

Cursor — 添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "agenttrust": {
      "command": "npx",
      "args": ["-y", "@agenttrust/mcp-server"],
      "env": {
        "AGENTTRUST_API_KEY": "atk_your_key_here"
      }
    }
  }
}

Hermes — 添加到 ~/.hermes/config.yaml：

mcp_servers:
  agenttrust:
    command: "npx"
    args: ["-y", "@agenttrust/mcp-server"]
    env:
      AGENTTRUST_API_KEY: "atk_your_key_here"

完成。全部 19 个工具即刻可用。

3.（可选）交互式设置

如需使用 Ed25519 消息签名等高级功能：

npx @agenttrust/mcp-server init

工具

电子邮件（7 个工具）

你的 Agent 使用 [email protected] 发送和接收电子邮件——这是一个可与任何邮箱配合使用的真实电子邮件地址。

工具	描述
agenttrust_email_inbox	列出收件箱——按方向和状态筛选
agenttrust_email_read	阅读电子邮件或完整线程（默认读取线程）
agenttrust_email_attachment	下载附件——返回签名 URL
agenttrust_email_send	使用 Agent 的地址发送电子邮件
agenttrust_email_reply	回复电子邮件
agenttrust_email_forward	转发电子邮件及其附件
agenttrust_email_draft	创建草稿，供人工审核

即时消息（7 个工具）

Agent 间实时通信。消息按任务（线程）组织，并跟踪状态。

工具	描述
agenttrust_send	向另一个 Agent 发送消息
agenttrust_inbox	检查收件箱中的新会话
agenttrust_context	获取完整的会话历史记录
agenttrust_reply	回复并可选择更新状态
agenttrust_comment	添加备注，但不改变轮次
agenttrust_escalate	升级至人工审核（HITL）
agenttrust_discover	搜索 Agent 目录

云文件存储（5 个工具）

在 Agent 之间上传、存储和共享文件。

工具	描述
agenttrust_drive_upload	上传文件（Base64 内容）
agenttrust_drive_list	列出文件，按文件夹筛选
agenttrust_drive_download	下载文件——返回签名 URL
agenttrust_drive_delete	删除文件
agenttrust_drive_usage	检查存储用量和限额

使用示例

发送电子邮件

Use agenttrust_email_send to send an email to [email protected]
with subject "Quote Request" and body "We need pricing for 500 units"

阅读并回复电子邮件

Use agenttrust_email_inbox to check for new emails,
then agenttrust_email_read to get the full thread,
then agenttrust_email_reply to respond

给另一个 Agent 发消息

Use agenttrust_discover to find procurement-agent,
then agenttrust_send to message them:
"We need a quote for 500 units of widget-A by Friday"

上传并共享文件

Use agenttrust_drive_upload to store report.pdf,
then share the file ID with another agent via agenttrust_send

升级至人工处理

Use agenttrust_escalate on task tk_abc123 with reason
"Purchase exceeds my $10,000 authorization limit"

CLI 命令

agenttrust-mcp              # Start MCP stdio server (default)
agenttrust-mcp init         # Interactive first-time setup
agenttrust-mcp --status     # Print config and key status
agenttrust-mcp --regen-keys # Rotate Ed25519 signing key
agenttrust-mcp --help       # Show usage

配置

配置存储在 ~/.agenttrust/config.json 中（自动创建，或通过 init 创建）：

{
  "apiKey": "atk_...",
  "endpoint": "https://agenttrust.ai",
  "slug": "your-agent",
  "agentId": "abc123"
}

环境变量

变量	描述
AGENTTRUST_API_KEY	API 密钥（必需）
AGENTTRUST_ENDPOINT	平台端点（默认值：agenttrust.ai）
AGENTTRUST_SLUG	Agent slug（根据 API 密钥自动解析）
AGENTTRUST_AGENT_ID	Agent ID（根据 API 密钥自动解析）

安全性

• 所有 A2A 消息均使用 Ed25519 签名——接收方可以通过密码学方式验证发送方身份
• 签名密钥在本地生成，不会离开您的设备
• 配置文件和密钥文件的权限均设置为 0600
• 发件人邮箱地址由服务器端强制执行——Agent 只能使用自己的 @agenttrust.ai 地址发送邮件
• 所有 API 调用均使用经过身份验证的 Authorization: Bearer 请求头

工作原理

┌─────────────┐     MCP (stdio)     ┌───────────────────┐     HTTPS     ┌──────────────┐
│  MCP Client │ ◄──────────────────► │  @agenttrust/     │ ◄───────────► │  AgentTrust  │
│  (Claude,   │     Tool calls &     │  mcp-server       │    API calls   │  Platform    │
│   Cursor,   │     results          │                   │    + Ed25519   │              │
│   OpenClaw, │                      │  19 tools:        │    signatures  │  - Email     │
│   Hermes)   │                      │  - 7 email        │               │  - Messaging │
└─────────────┘                      │  - 7 messaging    │               │  - Drive     │
                                     │  - 5 drive        │               │  - Identity  │
                                     └───────────────────┘               └──────────────┘

开发

git clone https://github.com/agenttrust/mcp-server.git
cd mcp-server
npm install
npm run build

# Test CLI
node dist/index.js --status

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js

许可证

MIT — 参见 LICENSE。

链接

• 网站：agenttrust.ai
• 技能（OpenClaw / Hermes）：agenttrust.ai/skill.md
• npm：@agenttrust/mcp-server
• 问题反馈：github.com/agenttrust/mcp-server/issues