mcp_agent_mail
为多个AI编程智能体提供类似邮件的协调层，避免冲突并共享上下文。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：mcp_agent_mail。 它的用途是：为多个AI编程智能体提供类似邮件的协调层，避免冲突并共享上下文。 完整的 Skill 内容见：https://321skill.com/skills/mcp-agent-mail/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请以‘架构师’的身份向MCP Agent Mail服务器注册，并查看当前有哪些活跃的智能体以及它们持有的文件租约。”，它会帮你完成身份注册并返回当前系统的协调状态。然后你可以说：“给负责前端开发的智能体‘UI-Master’发送一条消息，告知它API接口已更新，并附上修改的代码片段。”，它会通过Agent Mail发送一条带附件的Markdown消息，确保信息准确传递。
介绍
在同时运行多个AI编程智能体（如后端、前端、脚本）的项目中，智能体之间缺乏协调会导致代码覆盖、上下文丢失和人工协调成本高等问题。MCP Agent Mail 通过一个HTTP-only的FastMCP服务器，为智能体提供了邮箱、身份、可搜索的历史消息以及文件预留声明（租约）等功能，让它们能够像使用邮件系统一样进行异步通信和意图协调。
使用时，智能体可以向服务器注册一个身份（如“GreenCastle”），然后通过发送GitHub风格的Markdown消息进行通信。它们可以声明对特定文件或通配符的“租约”，以告知其他智能体自己的修改意图，从而避免编辑冲突。所有消息和操作都通过Git进行版本控制，便于人工审计，并通过SQLite进行索引和查询。
这个工具非常适合需要协调多个AI编程智能体（如Claude Code、Cursor、Gemini CLI等）进行并行开发的团队或开发者。它尤其适用于中大型项目，其中不同的智能体负责不同的模块或功能，需要共享进展和避免工作重叠。
请注意，该项目目前处于积极开发阶段。建议从项目文档中的规划指南开始，了解其设计理念和最佳实践。对于希望实现高度自动化协调的团队，可以关注其商业配套工具（Companion stack）以获取更强大的舰队管理和提示调度能力。
核心特点
核心区别在于它并非一个简单的消息队列，而是集成了Git版本控制用于审计、SQLite用于高效查询，并首创了“文件租约”机制来声明修改意图，从而在根源上预防了智能体间的文件编辑冲突。
注意事项
不适合仅使用单个AI智能体进行开发的简单项目，或对实时同步协作要求极高的场景。
常见问题
MCP Agent Mail 能防止代码冲突吗？
不能完全防止，但通过“文件租约”机制，智能体可以声明对文件的修改意图，其他智能体看到租约后会避免冲突性编辑，大幅降低冲突概率。
它支持哪些AI智能体？
设计上兼容任何支持FastMCP或HTTP协议的客户端，包括Claude Code、Cursor、Gemini CLI、Factory Droid等主流AI编程工具。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/mcp-agent-mail/raw/index.md 读取 mcp_agent_mail 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/mcp-agent-mail/raw/index.md（查看排版版本）