/ 目錄 / 演練場 / MCP Agent Mail
● 社群 Dicklesworthstone ⚡ 即開即用

MCP Agent Mail

作者 Dicklesworthstone · Dicklesworthstone/mcp_agent_mail

給你的程式代理艦隊配上電子郵件——身份識別、收件匣、可搜尋的討論串,以及顧問式檔案鎖定。再也不用擔心代理互相踩踏。

MCP Agent Mail 是一個純 HTTP 的 FastMCP 伺服器,賦予每個代理穩定的身份、收件匣/寄件匣、雜湊鏈審計日誌,以及自願性檔案預留鎖定。專為同時對同一個 monorepo 執行多個 Claude Code/Codex/Gemini CLI 實例的團隊設計,補足了凌晨 2 點有 3 個代理搶著重構同一個檔案時所缺少的協調層。

為什麼要用

核心特性

即時演示

實際使用效果

mcp-agent-mail.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-agent-mail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-agent-mail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-agent-mail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-agent-mail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-agent-mail",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8765/mcp"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-agent-mail": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "http://127.0.0.1:8765/mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add mcp-agent-mail -- npx -y mcp-remote http://127.0.0.1:8765/mcp

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: MCP Agent Mail

協調 3 個 Claude Code 工作階段在同一個 monorepo 上作業,避免合併衝突

👤 執行並行代理工作階段的團隊 ⏱ ~30 min intermediate

何時使用: 你為每個功能分支各自啟動代理,但它們一直搶佔相同的檔案。

前置條件
  • 每個代理都能連線的 Docker 主機docker compose up --build 對外開放 :8765
  • 每個代理取得唯一身份 — 第一次呼叫 whoami 即完成註冊;將其固定在 CLAUDE.md 中
步驟
  1. 身份識別
    使用 mcp-agent-mail。將我註冊為 claude-feature-auth,並列出目前有效的鎖定。✓ 已複製
    → 身份已持久化;鎖定列表已回傳
  2. 編輯前先宣告檔案
    編輯 src/auth/* 之前,先取得 30 分鐘的鎖定,並在 #refactor 討論串宣告意圖。✓ 已複製
    → 鎖定已授予;其他代理可見訊息
  3. 交接
    auth 模組完成了。釋放鎖定,並在 #refactor 貼上包含 diff 範圍的摘要。✓ 已複製
    → 鎖定已釋放;討論串已更新

結果: 三個代理在同一個 repo 上完成並行工作,且不會互相覆蓋彼此的編輯。

注意事項
  • 鎖定是自願性質——代理仍可忽略它 — 在 CLAUDE.md 加上規則:「編輯前務必確認鎖定,先宣告意圖」
搭配使用: filesystem · github

在處理關聯 repo 的代理之間交接工作

👤 同時管理前後端代理的開發者 ⏱ ~20 min intermediate

何時使用: 後端代理完成 API 變更;前端代理需要跟進調整。

步驟
  1. 發送
    claude-backend:傳送一則主旨為「新版 /v2/orders schema」的訊息給 claude-frontend,附上 OpenAPI diff。✓ 已複製
    → 訊息已發出;前端代理的收件匣計數遞增
  2. 接收
    claude-frontend:讀取收件匣,摘要新訊息,並提出元件更新建議。✓ 已複製
    → 前端代理確認變更並開始作業

結果: 代理之間非同步交接,無需你手動複製貼上提示。

注意事項
  • 跨機器的身份識別混淆 — 將身份綁定到主機名稱,或使用較長的隨機後綴

取得每則代理訊息與鎖定的鑑識記錄

👤 運維人員/除錯代理異常行為 ⏱ ~15 min intermediate

何時使用: 代理在凌晨 3 點做了奇怪的事,你需要重建誰告訴誰什麼。

步驟
  1. 搜尋
    搜尋 02:00 到 04:00 之間提及「database migration」的訊息。✓ 已複製
    → 回傳帶有雜湊錨點的條目
  2. 驗證鏈
    驗證審計鏈是否未遭竄改。✓ 已複製
    → 鏈結有效;防竄改偵測乾淨

結果: 可用於事後回顧的代理通訊防禦性記錄。

注意事項
  • 資料庫無限增長 — 安排保留期清理排程;每月封存至 S3
搭配使用: filesystem

組合

與其他 MCP 搭配,撬動十倍槓桿

mcp-agent-mail + filesystem

並行代理的鎖定後再編輯規範

任何 filesystem.write 之前,先透過 mcp-agent-mail 宣告鎖定。✓ 已複製
mcp-agent-mail + github

將 PR 通知發佈到其他代理訂閱的討論串

當我的 PR 合併時,將 SHA 與變更路徑發到 #merged。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
whoami (無) 任何代理的第一次呼叫 免費
send_message to, subject, body, thread? 將工作交接給另一個代理時 免費
read_inbox since?, limit? 工作階段開始時——查看待處理的訊息 免費
claim_lease path, ttl_min, reason 編輯其他代理可能會觸及的檔案之前 免費
release_lease lease_id 提交後/完成時 免費
search_messages query, from?, to? 鑑識或重新找回上下文時 免費

成本與限制

運行它的成本

API 配額
自行託管;受限於你的硬體
每次呼叫 Token 數
極少——每次協調呼叫約 50–200 個 token 的額外開銷
費用
免費(MIT 授權)
提示
執行成本低廉;省下的是你避免重複工作所省出的代理呼叫費用

安全

權限、密鑰、影響範圍

最小權限: 代理主機與郵件伺服器之間的網路存取
憑證儲存: 可選的 Bearer Token 存放於環境變數
資料出站: 保留在你的基礎設施上——不呼叫第三方
切勿授予: 未經 TLS + 驗證就公開暴露

故障排查

常見錯誤與修復

:8765 連線被拒

確認 Docker 容器已啟動且連接埠已轉發;執行 docker ps 確認

驗證: curl http://127.0.0.1:8765/health
身份識別衝突

附加隨機後綴,或綁定到主機名稱

鎖定被已停止的代理佔用

鎖定會依 TTL 自動過期;縮短預設 TTL,或使用管理工具強制釋放

替代方案

MCP Agent Mail 對比其他方案

替代方案何時用它替代權衡
共用 CLAUDE.md最多兩個代理,並行程度低無狀態——依賴代理讀取同一個檔案
每個代理使用獨立 Git 分支你想要硬性隔離合併成本隨之增長;無即時訊號

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills