Postal MCP

🚀 Postal: Agent Comms via MCP

Postal是一个用于实现两个智能体之间通信的邮箱系统，它借助SQLite支持的消息队列在智能体之间传递消息，能让智能体自由地相互发送消息。

🚀 快速开始

Postal创建了一个基于SQLite的消息队列，用于在智能体之间传递消息。MCP服务器仅支持HTTP，这意味着所有智能体共享同一个数据库和队列。

graph LR
subgraph Claude
    ccli[CLI]--send-->csm["send_message()"]
    crec["check_mailbox()"]
end
subgraph Gemini
    gcli[CLI]--send-->gsm["send_message()"]
    grec["check_mailbox()"]
end
postal[(postal)]
csm-->postal-->crec-->ccli
gsm-->postal-->grec-->gcli

✨ 主要特性

• 简单队列：Postal基于SQLite提供了一个简单的消息队列。
• MCP工具：提供了两个MCP工具，方便智能体之间的通信：
  • send_message(agent_name, message)：用于向指定智能体发送消息。
  • check_mailbox()：会阻塞，直到在自己的邮箱中收到消息。

💻 使用示例

基础用法

以下是一个简单的命令示例，展示了如何让Gemini智能体接收特定的提示信息：

PROMPT="Notice that you have two tools, check_mail and send_to_agent. You should get **all** instructions from check_mail. And you should get **all** clarification by using send_to_agent to reply to the agent that gave you a task. Your goal is to keep completing tasks forever and never ask the user for anything. Only talk to agents. You are gemini"

gemini --yolo --prompt "$PROMPT"

📚 详细文档

MCP配置

MCP服务以可流式传输的HTTP形式提供，路径格式为 /agents/{name}/mcp/。以下是不同的配置示例：

STDIO示例

{
  "mcpServers": {
    "postal": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://0.0.0.0:7777/agents/gemini/mcp", "--allow-http", "--transport", "http-only"]
    }
  }
}

直接使用HTTP示例

{
  "mcpServers": {
    "postal": {
      "url": "http://0.0.0.0:7777/agents/gemini/mcp",
      "transport": "http"
    }
  }
}

需要注意的是，"http" 的指定方式存在一些差异。有时使用 "streamable-http"，有时键名为 "type":。

🔧 技术细节

兼容性问题

Gemini CLI

Gemini的命令行界面（CLI）表现良好，没有太多问题。

Claude代码

Claude代码在返回邮箱操作上不太容易，需要大量的提示才能正常工作。