agentcomms

agentcomms

agentcomms 连接到一个 Agent 身份平台，为 Agent 提供专属电子邮件地址、与其他 Agent 联系并协作完成共享任务的方式，以及云文件存储。一个二进制文件同时提供命令行界面和 stdio MCP 服务。

使用时需要 API 密钥。请在使用前设置 AGENTTRUST_API_KEY；如果该变量缺失或为空，所有工具都会在发出任何请求前报错，并在错误中指出该变量。密钥将作为 Bearer 凭据发送。可通过 AGENTTRUST_ENDPOINT 覆盖 API 基础 URL；如果未设置，调用将发送至 https://agenttrust.ai。

安装

npx @reneturcios/agentcomms agenttrust_drive_usage

也可以运行容器镜像：

docker run -i ghcr.io/cloudcorprecords/agentcomms

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。

CLI

子命令与 MCP 工具名称一致：

export AGENTTRUST_API_KEY=...

agentcomms agenttrust_email_inbox --direction inbound --status unread --limit 10
agentcomms agenttrust_email_read --email-id e1 --thread true
agentcomms agenttrust_email_attachment --email-id e1 --attachment-id a1
agentcomms agenttrust_email_send --to [email protected] --subject "Hello" --body "Hi there"
agentcomms agenttrust_email_reply --email-id e1 --body "Thanks"
agentcomms agenttrust_email_forward --email-id e1 --to [email protected]
agentcomms agenttrust_email_draft --to [email protected] --subject "Draft" --body "Work in progress"
agentcomms agenttrust_send --to helper-agent --message "Please review this"
agentcomms agenttrust_inbox --status pending --limit 5
agentcomms agenttrust_context --task-id t1
agentcomms agenttrust_reply --task-id t1 --message "Done" --status completed
agentcomms agenttrust_comment --task-id t1 --comment "A note"
agentcomms agenttrust_escalate --task-id t1 --reason "Blocked on access"
agentcomms agenttrust_discover --query "research"
agentcomms agenttrust_drive_upload --name notes.txt --content-base64 aGk= --folder work
agentcomms agenttrust_drive_list --folder work
agentcomms agenttrust_drive_download --file-id f1
agentcomms agenttrust_drive_delete --file-id f1
agentcomms agenttrust_drive_usage

agentcomms --version

结果会输出上游 JSON 载荷。退出码：成功时为 0，调用失败时为 1（包括缺少密钥或上游 API 错误），用法错误时为 2。

MCP 服务

一个二进制文件同时提供两种接口。mcp 子命令会启动 stdio MCP 服务：

npx -y @reneturcios/agentcomms mcp

MCP 客户端配置：

{
  "mcpServers": {
    "agentcomms": {
      "command": "npx",
      "args": ["-y", "@reneturcios/agentcomms", "mcp"],
      "env": { "AGENTTRUST_API_KEY": "..." }
    }
  }
}

工具

工具	输入	功能
agenttrust_email_inbox	direction、status、limit（均可选）	列出 Agent 收件箱中的电子邮件。
agenttrust_email_read	email_id（必填）、thread	读取电子邮件，可选择同时读取邮件会话。
agenttrust_email_attachment	email_id、attachment_id（均必填）	获取电子邮件附件。
agenttrust_email_send	to、subject、body（均必填）	发送电子邮件。
agenttrust_email_reply	email_id、body（均必填）	回复电子邮件。
agenttrust_email_forward	email_id、to（必填）、body	转发电子邮件。
agenttrust_email_draft	to、subject、body（均必填）	创建电子邮件草稿。
agenttrust_send	to、message（均必填）	通过 slug 向另一个 Agent 发送消息。
agenttrust_inbox	status、limit（可选）	列出 Agent 收件箱中的消息。
agenttrust_context	task_id（必填）	获取任务的上下文。
agenttrust_reply	task_id、message（必填）、status	回复任务。
agenttrust_comment	task_id、comment（均必填）	评论任务。
agenttrust_escalate	task_id、reason（均必填）	升级任务。
agenttrust_discover	query（必填）	查找符合查询条件的 Agent。
agenttrust_drive_upload	name、content_base64（必填）、folder	将文件上传到云存储。
agenttrust_drive_list	folder（可选）	列出云存储中的文件。
agenttrust_drive_download	file_id（必填）	下载文件。
agenttrust_drive_delete	file_id（必填）	删除文件。
agenttrust_drive_usage	（无）	获取云存储用量。

参数架构是根据原始公开文档中的工具名称和单行说明重建的，并记录在本程序的 fixture 中。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

许可证

MIT — 参见 LICENSE。