saga-mcp — MCP-сервер для Claude Code: трекер задач агента
Даёт агенту базу задач в SQLite внутри проекта: эпики, подзадачи, зависимости и заметки. План не теряется между сессиями.
claude mcp add saga-mcp -- npx -y saga-mcpЧто делает saga-mcp
Агент забывает договорённости между сессиями, потому что план живёт в контекстном окне или в TODO.md, который никто не обновляет. saga-mcp заводит вместо этого файл SQLite в проекте: проекты, эпики, задачи, подзадачи, зависимости, комментарии, заметки и решения. Всё это открыто агенту как 41 инструмент MCP — он пишет туда по ходу работы и читает, когда возвращается. Ни аккаунтов, ни внешних сервисов, ни сетевых вызовов.
Единственная обязательная настройка — DB_PATH, путь к файлу .tracker.db. Файл и схема создаются при первом обращении. Есть и необязательные переменные: SAGA_PROJECT привязывает инструменты к одному проекту, SAGA_DESCRIPTION_LOCK со значением on_progress блокирует описание задачи, как только по ней началась работа, а SAGA_TOOLS со значением core оставляет 13 инструментов вместо 41 и экономит около 4,300 токенов за сессию.
Зависимости работают сами: задача с незакрытой зависимостью возвращается заблокированной и разблокируется, когда предыдущая завершена. Циклы сервер отклоняет, а не уходит в дедлок. Инструмент tracker_next выдаёт одну рекомендацию с причиной, tracker_dashboard — общую картину со статистикой, просроченным и заблокированным. Проверено на Node 20, 22 и 24, на Linux, macOS и Windows.
Какие задачи решает
- восстановить план работы агента после перезапуска сессии
- связать задачи зависимостями и не начинать заблокированную
- получить одну рекомендацию, что делать дальше, с обоснованием
- убрать завершённые задачи из контекста, не теряя их
- посмотреть состояние проекта в браузере через
saga-web
Примеры запросов агенту
- Настрой трекинг для проекта e-commerce API и распланируй авторизацию.
- Где мы остановились?
- Покажи дашборд по текущему проекту.
Как установить saga-mcp
Командой платформы
claude mcp add saga-mcp -- npx -y saga-mcpКомандой платформы
codex mcp add saga-mcp -- npx -y saga-mcpФайл настроек
{
"mcpServers": {
"saga-mcp": {
"command": "npx",
"args": [
"-y",
"saga-mcp"
]
}
}
}Файл настроек
{
"servers": {
"saga-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"saga-mcp"
]
}
}
}Командой платформы
gemini mcp add saga-mcp npx -y saga-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о saga-mcp
Как установить saga-mcp в Claude Code?
Выполните claude mcp add saga-mcp -- npx -y saga-mcp, затем перезапустите клиент. Для других MCP-клиентов тот же блок с command и args подходит без изменений.
Что делает saga-mcp?
Хранит проекты, эпики, задачи, подзадачи, зависимости, комментарии и решения в файле SQLite внутри проекта и отдаёт их агенту как 41 инструмент MCP. Агент пишет в базу по ходу работы и читает её в следующей сессии.
Нужны ли API-ключи или внешний сервис?
Нет. База — это файл, который вы держите у себя, сетевых вызовов сервер не делает. Обязательна только переменная DB_PATH.
