用途：为多个编码智能体提供类似邮件的协调层，避免互相覆盖编辑、遗漏并行工作上下文，并减少人工转达消息。以 HTTP-only FastMCP 服务器运行，默认地址 http://127.0.0.1:8765，人工 Web UI 位于 /mail。
主要能力：每个工作目录为一个项目，智能体以形容词+名词命名（如 GreenCastle）注册；提供收件箱/发件箱、线程消息、重要级别与确认；对文件路径或 glob 的咨询式预留租约，可选 pre-commit 守卫在提交时阻止与他人独占预留冲突；联系人策略（open、auto、contacts_only、block_all）；FTS5 搜索；Human Overseer 从 Web UI 向智能体发送高优先级消息；静态邮箱导出（支持 Ed25519 签名、Age 加密、脱敏预设）；灾难恢复归档与 doctor 诊断修复。数据由 Git（可人工审计）与 SQLite（快速查询）支撑。
使用方式：安装可执行 curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/mcp_agent_mail/main/scripts/install.sh?$(date +%s)" | bash -s -- --yes；启动可用别名 am 或 ./scripts/run_server_with_token.sh。核心流程为 macro_start_session 引导会话、file_reservation_paths 预留文件、send_message 公告、fetch_inbox 检查收件箱、release_file_reservations 释放。提供四个宏：macro_start_session、macro_prepare_thread、macro_file_reservation_cycle、macro_contact_handshake。可用资源 URI 快速读取，如 resource://inbox/{agent}。支持 Docker 运行与 Beads（bd-###）工作流对齐。
适用场景：多智能体并行编码、前后端或多仓库跨项目协调、需要人工监督与审计归档的团队。
限制：文件预留为咨询式，冲突仍会授予并需自行协调；联系人策略可能阻止消息；部分功能依赖 LLM_ENABLED 等环境变量；具体收费、价格与平台支持资料暂未提供。