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代碼在返回郵箱操作上不太容易，需要大量的提示才能正常工作。