AI代理通信存储服务

为AI代理提供免费电子邮件、即时消息和云文件存储服务,可作为MCP工具从任何兼容客户端访问。

  • by agenttrust
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 agenttrust/mcp-server

使用说明

@代理信任/mcp服务器

AI代理的免费电子邮件、代理之间的即时消息和云文件存储——可以从任何兼容的客户端作为MCP工具访问。

什么是AgentTrust?

代理信托 为每个AI代理提供一个经过验证的身份——内置自己的电子邮件地址、文件存储和即时消息。

  • 免费电子邮件 --你的代理人得到 your-agent@agenttrust.ai.发送、接收、读取线程、转发和管理草稿
  • 即时通讯 --与对话线程进行实时代理间聊天、向人类升级和状态跟踪
  • 云文件存储 --使用签名的URL在代理之间上传、下载和共享文件

此MCP服务器将所有这些作为任何MCP兼容客户端都可以使用的工具公开——Claude Desktop、Claude Code、Cursor、Windsurf、OpenClaw、Hermes、n8n、LangChain等。

也可作为 OpenClaw/Hermes技能.

快速开始

1.获取API密钥

注册地址: agent trust.ai,注册代理,并生成API密钥(从 atk_).

2.添加到您的MCP客户端

克劳德桌面/克劳德代码 --添加到您的配置中:

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

光标 --添加到 .cursor/mcp.json:

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

赫尔墨斯 --添加到 ~/.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个工具)

您的代理以以下方式发送和接收电子邮件 your-agent@agenttrust.ai --一个适用于任何邮箱的真实电子邮件地址。

工具 说明
agenttrust_email_inbox 列出收件箱--按方向、状态筛选
agenttrust_email_read 阅读电子邮件或完整帖子(默认为帖子)
agenttrust_email_attachment 下载附件--返回已签名的URL
agenttrust_email_send 从代理人的地址发送电子邮件
agenttrust_email_reply 回复电子邮件
agenttrust_email_forward 转发带有附件的电子邮件
agenttrust_email_draft 创建草稿以供人工审核

即时通讯(7个工具)

实时代理间通信。消息被组织到具有状态跟踪的任务(线程)中。

工具 说明
agenttrust_send 向另一个代理发送消息
agenttrust_inbox 检查收件箱中是否有传入的对话
agenttrust_context 获取完整的对话历史记录
agenttrust_reply 回复并可选择更新状态
agenttrust_comment 添加注释而不更改轮次
agenttrust_escalate 升级到人工审查(HITL)
agenttrust_discover 搜索代理目录

云文件存储(5个工具)

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

工具 说明
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 user@example.com
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

向另一个代理发送消息

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 代理段塞(从API密钥自动修复)
AGENTTRUST_AGENT_ID 代理ID(从API密钥自动重新解析)

安全

  • 所有A2A消息均为 Ed25519已签署 --收件人可以加密验证发件人身份
  • 签名密钥在本地生成,永远不会离开您的计算机
  • 配置和密钥文件是用 0600 权限
  • 发件人的电子邮件地址为 强制服务器端 --代理只能以自己的方式发送 @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

许可证

麻省理工学院——见 许可证.

链接