local-agent-board
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@local-agent-board check if web/review is locked and post a note to Reviewer that tests pass"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Local Agent Board
Локальная почта и блокировки тем для AI-агентов, которые работают над одним проектом в разных сессиях или Git worktree. Один агент может сообщить, что задача готова к проверке, а другой может увидеть, свободна ли нужная область работы. Сообщения и отметки о прочтении сохраняются в SQLite между запусками. Для человека доступна веб-доска с блокировками и 25 последними сообщениями.
Проект основан на сценариях и устройстве кода форка agent-exchange. Хранилище, интерфейсы и веб-доска реализованы отдельно на Python 3.9+ и стандартной библиотеке. Исходное уведомление MIT сохранено в LICENSE.
Быстрый старт
Из каталога проекта выполните команды. Они используют временную базу и данные для примера.
board_dir="$(mktemp -d)"
python3 -m agent_board --data "$board_dir" --agent Codex lock demo/tests --ttl 900 --note "Проверяю тесты"
python3 -m agent_board --data "$board_dir" --agent Codex post Reviewer demo/tests "Проверь отчёт."
python3 -m agent_board --data "$board_dir" --agent Reviewer inbox --unread
python3 -m agent_board --data "$board_dir" --agent Reviewer ack 1
python3 -m agent_board --data "$board_dir" serveПоследняя команда напечатает адрес локальной доски. Откройте его в браузере и нажимайте «Обновить», чтобы перечитать состояние. Для Markdown выполните python3 -m agent_board --data "$board_dir" snapshot.
В постоянной работе укажите один абсолютный путь --data на проект и передавайте его всем участникам, включая процессы из других worktree. По умолчанию используется .agent-board в текущем каталоге. Команда python3 -m agent_board --help перечисляет операции. После установки через python3 -m pip install . с актуальным pip доступна команда local-agent-board.
Related MCP server: hardline-mcp
Подключение MCP
Для клиента с конфигурацией mcpServers добавьте сервер по образцу. Укажите абсолютные пути к Python, каталогу исходников и общей папке данных. Во второй конфигурации поменяйте значение --agent на Reviewer, сохранив тот же путь --data. Сервер поддерживает MCP stdio версий 2025-11-25 и 2025-06-18. Спецификация транспорта
{
"mcpServers": {
"local-agent-board": {
"command": "/usr/bin/python3",
"args": ["-m", "agent_board", "--data", "/absolute/path/to/project-board", "--agent", "Codex", "mcp"],
"env": {
"PYTHONPATH": "/absolute/path/to/local-agent-board"
}
}
}
}Инструмент MCP | Действие |
| Отправляет текст одному получателю или всем через адрес |
| Показывает входящие, начиная с новых. Поддерживает |
| Отмечает список |
| Занимает тему на |
| Продлевает действующую блокировку с её токеном. |
| Освобождает блокировку с её токеном. |
| Показывает владельцев, сроки и истёкшие блокировки. |
Как устроен обмен
Имена агентов регистрозависимы. Тема нормализуется по регистру и пробелам. Удобно договориться о едином формате, например
web/review.Рассылка
*появляется во входящих каждого участника. Отметка о прочтении хранится отдельно для каждого имени.Срок блокировки по умолчанию составляет 30 минут. Для продления или освобождения используйте токен из ответа
lock. После повторного захвата старый токен теряет силу, даже если оба процесса работают под одним именем. При захвате истёкшей блокировки прежний владелец получает внутреннее уведомление.CLI и MCP используют одно транзакционное хранилище. Веб-доска привязана к
127.0.0.1и показывает только состояние базы. Отдельная командаsnapshotпечатает Markdown в stdout.
Блокировки действуют по соглашению участников. Изменения в Git и файловой системе остаются под контролем каждого агента. Доска рассчитана на доверенные процессы одного пользователя ОС. Имя задаётся при запуске процесса, а пользователь с доступом к файлу SQLite может прочитать данные. Для новой доски требуется своя папка. Схема SQLite отличается от схемы исходного форка.
Проверка
python3 -m unittest discover -s tests -vТесты используют временные каталоги и проверяют доставку, отметки о прочтении, истечение и конкурентный захват блокировок, обмен через CLI и MCP, а также доступ к веб-доске.
Available Tools
7 toolsackC
Mark addressed messages as read in your mailbox.
Inputs: ids (required).
inboxBRead-only
Read your direct messages and broadcasts, newest first. Use next_before to continue.
Inputs: limit, topic, before, unread.
lockB
Reserve a topic and return the token required for renewal and release.
Inputs: topic (required), ttl, note.
lock_statusARead-only
List leases with their holder, expiry, and current status.
Inputs: no named parameters.
postB
Send a plain-text coordination message to an agent or to everyone.
Inputs: body (required), topic (required), recipient (required).
renewB
Extend your existing, unexpired lease from the current time.
Inputs: token (required), topic (required), ttl.
unlockB
Release the lease identified by your token.
Inputs: token (required), topic (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool maps to a clearly distinct action in one of two domains: lease management (lock, renew, unlock, lock_status) and messaging (post, inbox, ack). No two tools can reasonably be confused for the same operation.
Most names are short action verbs (lock, renew, unlock, post, ack), with two noun-oriented names (lock_status, inbox). The convention is mostly predictable but not uniformly verb_noun.
Seven tools is well-scoped for a local agent coordination board. Each tool covers a necessary operation and there is no redundant surface.
The lease lifecycle is fully covered (acquire, renew, release, inspect), and messaging supports send, read, and acknowledge. Minor gaps exist around retracting/editing posted messages or listing known agents, but core workflows are complete.
Maintenance
Related MCP Connectors
End-to-end encrypted messaging and work coordination for autonomous AI agents.
Durable agent-to-agent handoffs and shared scratchpad for multi-agent workflows.
The communications layer for AI agents: posts, DMs, team rooms, and file exchange.
Shared project context for AI agents and teams: docs, tasks, and messages that stay current.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables multiple AI agents to communicate and coordinate via a shared SQLite-backed message log, supporting directed messages, broadcasts, and session discovery.-
- AlicenseAqualityBmaintenanceEnables local AI coding agents to message each other on one machine using a durable SQLite mailbox and live-ask tools.93MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to exchange structured work items with an auditable lifecycle, supporting send, acknowledge, block, complete, and cancel operations via a shared SQLite-backed inbox.35 npm2Apache 2.0
- AlicenseBqualityBmaintenanceEnables AI agents from different frameworks to communicate asynchronously via a persistent SQLite-backed bus, with doorbell wakeups for sub-second notifications and full message history.6MIT