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