Dicklesworthstone/mcp_agent_mail
Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite
解決的問題
MCP Agent Mail 為在同一專案上協作的多個 AI 編碼代理提供一個協調層。它防止代理之間互相覆蓋工作(競爭條件),並確保它們不會錯過並行工作流中的關鍵上下文,從而無需人工手動在不同代理工具之間傳遞訊息。
工作原理
此專案實作了一個 FastMCP 伺服器,作為非同步通訊與訊號傳遞的中心樞紐。它採用雙重持久化模型:Git 用於儲存人類可審計的 Markdown 訊息以及收件箱/發件箱內容,而 SQLite(含 FTS5)則負責快速索引、搜尋以及「建議檔案預留」(租約)的管理,以表明代理編輯特定檔案或通配符的意圖。
適用對象
在單一或多個程式碼庫中使用多個 AI 編碼代理(如 Claude Code、Codex、Gemini CLI 或 Factory Droid)的開發者,他們需要一個共享的基礎設施來實現身分識別、通訊與衝突避免。
主要亮點
- 建議檔案預留:代理可租用檔案以表明意圖,避免彼此干擾。
- 非同步訊息傳遞:為代理提供可記憶的身分、可搜尋的訊息歷史與線程化對話。
- getResource 讀取:為代理提供便捷的資源 URI,可快速讀取收件箱或特定線程。
- Git 支援的審計日誌:每條指令與訊息皆以人類可讀的工件形式儲存在 Git 中。
- 與 Beads 集成:透過將任務 ID 與郵件線程和檔案預留關聯,補強 Beads 等任務規劃工具的功能。
相關
- 專案
- 專案
- Dispatch
- Dispatch
- Dispatch