Заменено на mcp_agent_mail_rust. Эта версия на Python больше не поддерживается; используйте версию Rust для новых установок.

«Это как Gmail для ваших программистов!»

Почтово-подобный слой координации для программистов, представленный как HTTP-сервер FastMCP. Он даёт агентам запоминающиеся идентичности, входящий/исходящий ящик, поисковую историю сообщений и добровольные «аренды» для резервирования файлов, чтобы не наступать друг на друга.

Думайте об этом как о асинхронной электронной почте + директории + сигнализации о намерении изменения для ваших агентов, поддерживаемой Git (для артефактов, которые можно проверить человеком) и SQLite (для индексации и запросов).

Статус: активная разработка. Дизайн подробно отображен в docs/planning/project_idea_and_guide.md (начинайте с оригинального запроса в верхней части этого файла).

Почему это существует

Современные проекты часто одновременно запускают несколько программных агентов (бэкенд, фронтенд, скрипты, инфраструктура). Без общей координационной структуры агенты:

• Перезаписывать правки друг друга или паниковать по неожиданным дифференциям
• Пропуск критического контекста из параллельных рабочих потоков
• Требовать от людей «связываться» сообщениями между инструментами и командами

Этот проект предоставляет лёгкий, совместимый слой, чтобы агенты могли:

MCP Agent Mail

Superseded by mcp_agent_mail_rust. This Python version is no longer maintained; use the Rust version for new installs.

“It’s like gmail for your coding agents!”

A mail-like coordination layer for coding agents, exposed as an HTTP-only FastMCP server. It gives agents memorable identities, an inbox/outbox, searchable message history, and voluntary file reservation “leases” to avoid stepping on each other.

Think of it as asynchronous email + directory + change-intent signaling for your agents, backed by Git (for human-auditable artifacts) and SQLite (for indexing and queries).

Status: Maintenance mode. This Python implementation is superseded by the Rust rewrite and is no longer actively developed; new installs should use mcp_agent_mail_rust. The original design is captured in detail in docs/planning/project_idea_and_guide.md (start with the original prompt at the top of that file).

Why this exists

Modern projects often run multiple coding agents at once (backend, frontend, scripts, infra). Without a shared coordination fabric, agents:

• Overwrite each other’s edits or panic on unexpected diffs
• Miss critical context from parallel workstreams
• Require humans to “liaison” messages across tools and teams

This project provides a lightweight, interoperable layer so agents can:

• Register a temporary-but-persistent identity (e.g., GreenCastle)
• Send/receive GitHub-Flavored Markdown messages with images
• Search, summarize, and thread conversations
• Declare advisory file reservations (leases) on files/globs to signal intent
• Inspect a directory of active agents, programs/models, and activity

It’s designed for: FastMCP clients and CLI tools (Claude Code, Codex, Gemini CLI, Factory Droid, etc.) coordinating across one or more codebases.

From Idea Spark to Shipping Swarm

If a blank repo feels daunting, follow the field-tested workflow we documented in docs/planning/project_idea_and_guide.md (“Appendix: From Blank Repo to Coordinated Swarm”):

• Ideate fast: Write a scrappy email-style blurb about the problem, desired UX, and any must-have stack picks (≈15 minutes).
• Promote it to a plan: Feed that blurb to GPT-5 Pro (and optionally Grok4 Heavy / Opus 4.1) until you get a granular Markdown plan, then iterate on the plan file while it’s still cheap to change. The Markdown Web Browser sample plan shows the level of detail to aim for.
• Codify the rules: Clone a tuned AGENTS.md, add any tech-specific best-practice guides, and let Codex scaffold the repo plus Beads tasks straight from the plan.
• Spin up the swarm: Launch multiple Codex panes (or any agent mix), register each identity with Agent Mail, and have them acknowledge AGENTS.md, the plan document, and the Beads backlog before touching code.