MCP Agent Mail (Rust)
Почтовый сервер для агентов на одном репозитории: письма, ветки переписки, брони файлов и 16-экранный TUI
- 234 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Установщик скачивает бинарник и сам правит конфигурации найденных агентов, включая Codex CLI
- Сервер слушает локальный порт `127.0.0.1:8765`, а письма и профили агентов записываются файлами в Git-репозитории проектов
- Хук pre-commit может заблокировать коммит, если файл занят другим агентом
Установка
- Работает в
Ручная установка
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/mcp_agent_mail_rust/main/install.sh?$(date +%s)" | bashLinux и macOS. Скачивает бинарник под платформу, проверяет подпись через `minisign` и прописывает найденных агентов.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установщик скачивает бинарник и сам правит конфигурации найденных агентов, включая Codex CLI
- Сервер слушает локальный порт `127.0.0.1:8765`, а письма и профили агентов записываются файлами в Git-репозитории проектов
- Хук pre-commit может заблокировать коммит, если файл занят другим агентом
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP Agent Mail — локальный почтовый сервер для нескольких агентов, которые работают над одним репозиторием. Каждый агент получает постоянное имя вроде `GreenCastle`, входящие и исходящие, ветки переписки и брони файлов. Письма пишутся в Git-архив проекта и индексируются в SQLite, поэтому их читают и человек, и поиск, а контекст агента они не занимают. Сервер отдает 45 инструментов и 25 ресурсов MCP. Агент регистрирует проект и себя, бронирует маски вроде `src/**` на срок, в режиме «эксклюзивно» или «совместно», шлет письма с запросом подтверждения и читает ящик. Хук pre-commit блокирует коммиты по файлам, которые заняты другим агентом. За работой следит оператор: 16-экранный TUI, веб-интерфейс по адресу `/mail/` и команда `am robot` с выводом `toon` или `json`. Это переписанная на Rust версия Python-проекта mcp_agent_mail.
Для кого. Тем, кто запускает несколько агентов (Claude Code, Codex, Gemini CLI) на одном репозитории и разбирает правки, которые агенты затирают друг у друга.
Подходит, если
- Бэкенд, фронтенд и скрипты ведут разные агенты, и им надо договориться, кто какие файлы правит
- Агент упал или потерял контекст, а переписка с остальными должна сохраниться: она лежит в Git-архиве
- Хочется видеть, о чем договорились агенты, в TUI или в браузере, без пересказа в чате
- Задачи из Beads привязываются к веткам переписки через `thread_id`, и обсуждение остается рядом с задачей
Не подходит, если
- Агент один: брони файлов и почта добавят обвязку без пользы
- Агенты работают на разных машинах без общей файловой системы: сервер рассчитан на одну машину
- Нужна единая служба входа для нескольких серверов: поддержка JWT есть, но каждый сервер хранит свои токены сам
Пример запроса к агенту
Зарегистрируйся в Agent Mail, забронируй `src/auth/**` на час и напиши BlueLake, что начинаешь рефакторинг авторизацииMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
AM_SEARCH_SEMANTIC_ENABLED- Включает семантический и гибридный поиск в сборках с функцией hybrid. Без нее все запросы идут лексическим поиском.
Ограничения
Бронь файлов рекомендательная: агент обходит хук командой `git commit --no-verify`. Для сборки из исходников нужен Rust nightly. На рое из 60 агентов вызовы `file_reservation_paths` и `release_file_reservations` отвечали в версии 0.3.39 за 4,7 с в медиане и около 15 с на 99-м процентиле при целевых 5 с. Лицензия — MIT с добавлением: права не даны OpenAI, Anthropic, их аффилированным лицам и тем, кто действует от их имени. Условия лежат в файле `LICENSE`, и сотрудникам этих компаний перед использованием стоит их прочитать.
Как отключить. Остановите сервер, уберите запись `agent-mail` из `.mcp.json` или конфигурации агента и удалите хук pre-commit в репозитории. Полное удаление делает `install.sh` с флагом `--uninstall`.
Частые вопросы
Как подключить Agent Mail к Claude Code?
Установщик прописывает найденных агентов сам, повторить настройку можно командой `am setup run`. Вручную добавьте в `.mcp.json` сервер `agent-mail` с командой `mcp-agent-mail` либо с адресом `http://127.0.0.1:8765/mcp/`, если сервер уже запущен.
Нужен ли отдельный сервер на каждый проект?
Нет, один сервер ведет несколько проектов. Проект определяется абсолютным путем к репозиторию, который передают как `project_key`.
Могут ли агенты из разных репозиториев переписываться?
Да. Либо оба репозитория используют один `project_key`, либо проекты остаются отдельными, связываются вызовом `macro_contact_handshake`, и адресата пишут как `Имя@проект`.
Что делать, если сервер упал?
Рабочее состояние хранится в SQLite, а Git-архив служит журналом восстановления. После повреждения базы `am doctor reconstruct` пересобирает SQLite из архива.
Работает ли Agent Mail с подпиской Claude Max?
Да. Каждый сеанс агента подключается к одному и тому же MCP-серверу независимо от тарифа подписки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP Agent Mail
mcp_agent_mail
Почтовый слой координации для кодовых агентов: у агентов постоянные имена, входящие и исходящие, поиск по истории и добровольные резервы файлов
Менеджер на Rust собирает MCP-сервисы под одним демоном: CLI, веб-интерфейс, HTTP API и SDK для Python и Rust
Универсальный CLI-клиент MCP от Apify: постоянные сессии, OAuth, JSON-вывод для скриптов и доступ агента к любому MCP-серверу через оболочку
MCP-сервер, который вставляет в задачи агента шаг обратной связи: веб или десктоп-окно для текста, картинок и промптов
MCP-сервер UseAgent передает задачи удаленным агентам, собирает результаты и сохраняет запуски в журнале организации.
MCP-сервер и CLI координируют специализированных агентов, сохраняют рабочие шаблоны и связывают задания с хуками проекта.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP Agent Mail (Rust) (эта карточка) | нет | не нужна | 234 | |
| MCP Agent Mail | нет | API-ключ | 2 232 | Python-оригинал с той же моделью почты и броней; Rust-версия добавляет 16-экранный TUI, команду `am robot`, поиск V3, слоты сборки и шину для нескольких проектов. |
| Beads | нет | 28 540 | Beads ведет задачи и зависимости, а Agent Mail возит разговоры между агентами; по документации их связывает номер задачи в роли `thread_id`. |
Коротко о README
README подробно описывает установку с проверкой подписи релиза, настройку Claude Code, Codex CLI и Gemini CLI, все 45 инструментов, режимы сервера, TUI и робот-режим. Отдельные разделы посвящены алгоритмам бронирования, модели согласованности, поиску и замерам производительности против Python-версии.