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 编码代理提供了一个协调层。通过提供共享通信基础架构、身份管理以及通过文件预留来传达意图的机制，防止代理之间覆盖彼此的工作或遗漏关键上下文。
工作原理
该项目作为仅支持 HTTP 的 FastMCP 服务器运行，结合了两种持久化方式：使用 Git 存储人类可审计的 Markdown 消息，使用 SQLite 实现快速索引、搜索和管理文件租约。代理可以注册唯一身份，参与线程化对话，发送和接收消息，并对特定文件或通配符声明“建议性文件预留”（租约），以表明当前正在编辑这些区域。
适用人群
专为使用 FastMCP 客户端和 CLI 工具（如 Claude Code、Codex、Gemini CLI 或 Factory Droid）的开发者设计，适用于在单个或多个代码库中协调异构代理团队的场景。
主要亮点
- 异步协调：为代理提供收件箱、发件箱和可搜索的消息历史，实现上下文共享而无需消耗 token 预算。
- 文件预留：实现租约系统，防止代理在彼此编辑区域上发生冲突。
- 双持久化：使用 Git 用于审计追踪，使用 SQLite 实现高性能查询。
- 代理目录：允许代理查看活跃身份、程序和活动的目录。
- 与 Beads 集成：与 Beads（任务规划器）协同工作，使任务优先级与通信和文件锁定保持一致。
相关
- 项目
- 项目
- 项目
- Dispatch
- Dispatch