mcp-state-sidecar — MCP-сервер для Claude Code: состояние агентов
Выносит состояние многоагентных воркфлоу в отдельный MCP-сервер: ключи, воркфлоу, лизы и история переживают падение процесса.
claude mcp add mcp-state-sidecar -- uvx mcp-state-sidecarЧто делает mcp-state-sidecar
Агенты хранят состояние у себя, и при краше, горизонтальном масштабировании или переходе между фреймворками оно теряется. mcp-state-sidecar решает это иначе: агент обращается к нему теми же вызовами инструментов, что и к любому другому MCP-серверу. Внутри — пять групп инструментов. Key-Value Store (state_set, state_get, state_delete, state_list) с опциональным TTL. Workflow Lifecycle (workflow_create, workflow_claim, workflow_checkpoint, workflow_resume, workflow_status, workflow_discover, workflow_list) для координации распределённых воркеров. Лизы и блокировки (lease_acquire, lease_release, lease_renew), сессии и история (session_save, session_restore, history_log), наблюдаемость (sidecar_health, sidecar_reset).
Запускается в двух режимах. HTTP SSE — основной для распределённых сред: mcp-state-sidecar-http слушает 0.0.0.0 на порту 8000, эндпоинт http://localhost:8000/mcp. Stdio — для локального запуска как подпроцесса: mcp-state-sidecar. Настройка идёт только через переменные окружения: STATE_BACKEND (sqlite или redis), DB_PATH, REDIS_URL, SIDECAR_HOST, SIDECAR_PORT.
Бэкендов два: SQLite с WAL-режимом и сериализацией либо Redis для высокой конкурентности. Для Redis нужна отдельная установка — pip install mcp-state-sidecar[redis], без неё этот бэкенд не поднимется. sidecar_reset стирает все данные без возможности отката, так что на живом стенде его лучше не трогать.
Какие задачи решает
- сохранить состояние воркфлоу между запусками агента
- атомарно захватить воркфлоу, чтобы два воркера не взяли одну задачу
- продолжить работу с последнего шага после падения процесса
- выдать агенту эксклюзивную блокировку на ресурс с TTL
- посмотреть историю переходов состояния с автором записи
Примеры запросов агенту
- Создай воркфлоу с тегом
ingestи покажиrun_id - Захвати воркфлоу
run_idза агентомworker-3и запиши чекпоинт шага 2 - Сохрани контекст сессии
session-42, потом восстанови его
Как установить mcp-state-sidecar
Командой платформы
claude mcp add mcp-state-sidecar -- uvx mcp-state-sidecaruvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-state-sidecar <команда>
Командой платформы
codex mcp add mcp-state-sidecar -- uvx mcp-state-sidecaruvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-state-sidecar <команда>
Файл настроек
{
"mcpServers": {
"mcp-state-sidecar": {
"command": "uvx",
"args": [
"mcp-state-sidecar"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-state-sidecar <команда>
Файл настроек
{
"servers": {
"mcp-state-sidecar": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-state-sidecar"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-state-sidecar <команда>
Командой платформы
gemini mcp add mcp-state-sidecar uvx mcp-state-sidecaruvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-state-sidecar <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-state-sidecar
Как установить mcp-state-sidecar в Claude Code?
Одной командой: claude mcp add mcp-state-sidecar -- uvx mcp-state-sidecar. Пакет ставится через uvx, отдельная установка не нужна.
Что делает mcp-state-sidecar?
Это MCP-сервер для хранения состояния многоагентных воркфлоу: ключи с TTL, реестр воркфлоу с захватом и чекпоинтами, лизы для блокировок, снимки сессий и журнал переходов.
Какие бэкенды поддерживаются?
SQLite с WAL-режимом и Redis для высокой конкурентности. Redis требует установки с extra: pip install mcp-state-sidecar[redis].
