mcp_agent_mail

AI 編碼代理的非同步協調層:身份、收件匣、可搜尋的討論串,以及基於 FastMCP + Git + SQLite 的建議性檔案租約

mcp_agent_mail 是什麼?

AI 編碼代理的非同步協調層:身份、收件匣、可搜尋的討論串,以及基於 FastMCP + Git + SQLite 的建議性檔案租約

mcp_agent_mail 概覽

這是什麼

MCP Agent Mail 是一個類似郵件的協調層,專為 AI 編碼代理設計,以 HTTP-only FastMCP 伺服器形式提供。它賦予代理可記憶的身份、收件匣/寄件匣、可搜尋的訊息歷史,以及自願性的檔案保留「租約」以避免衝突。系統以 Git(供人類稽核的工件)和 SQLite(索引與查詢)為基礎。此 Python 實作已被 Rust 重寫版(mcp_agent_mail_rust)取代,不再積極維護;新安裝應使用 Rust 版本。

主要功能

  • 註冊暫時但持久的身份(例如 GreenCastle)
  • 傳送與接收 GitHub-Flavored Markdown 訊息(含圖片)
  • 搜尋、摘要與串接對話
  • 宣告建議性檔案保留租約(leases)於檔案或 glob 模式,以表明意圖
  • 檢視活躍代理、程式/模型與活動的目錄
  • 以 Git(可稽核工件)和 SQLite(索引與查詢)為後端

使用情境

現代專案常同時執行多個編碼代理(後端、前端、腳本、基礎設施)。若無共享協調層,代理會覆蓋彼此的編輯、錯失平行工作流程的關鍵脈絡,或需要人類在工具間傳遞訊息。MCP Agent Mail 提供輕量、可互操作的層,讓代理能透過 FastMCP 客戶端與 CLI 工具(Claude Code、Codex、Gemini CLI、Factory Droid 等)在一個或多個程式碼庫間協調。

快速開始

一行安裝指令:

curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/mcp_agent_mail/main/scripts/install.sh?$(date +%s)" | bash -s -- --yes

安裝後,在任何位置輸入以下指令即可啟動伺服器:

am

若想手動安裝,請複製儲存庫,使用 uv 建立 Python 3.14 虛擬環境,然後執行伺服器腳本。

授權與價格

此專案為開源。授權條款未在元資料中說明(NOASSERTION)。

內容整理自該專案公開的 README 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/dicklesworthstonemcp-agent-mail.svg)](https://yunodb.com/tools/dicklesworthstonemcp-agent-mail?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/dicklesworthstonemcp-agent-mail?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/dicklesworthstonemcp-agent-mail.svg" alt="Featured on YunoDB" height="20"></a>