saga-mcp

saga-mcp

spranabMIT
25 звёзд4 форков
saga-mcp — это MCP-сервер для управления проектами. Он работает как Jira, но внутри AI-ассистента. Данные хранятся локально в SQLite-файле .tracker.db. Никаких внешних серверов, регистраций и ключей API. Всё полностью под вашим контролем. Главная проблема LLM — потеря контекста между сессиями. saga-mcp решает её: каждое изменение задач, заметок и комментариев фиксируется в структурированной базе. Модель всегда видит полную историю проекта, зависимости и временные затраты. Сервер подходит разработчикам и командам, которые хотят передать AI-агенту ведение бэклога и контроль статусов.
Ai-mlProductivityDatabasesJira
Открыть на GitHub

Установка

npx -y saga-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикspranab
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Создавайте проекты, эпики, задачи и подзадачи — полная вложенная иерархия.
  • Связывайте задачи через зависимости: блокирующие или последовательные.
  • Подгружайте шаблоны задач с подстановкой переменных — ускорьте рутину.
  • Смотрите общую картину через дашборд: статусы, сроки, текстовое резюме.
  • Оставляйте заметки: решения, контекст, встречи, блокеры привязаны к задачам.
  • Следите за историей: каждое мутирующее действие логируется, часы считаются автоматически.
  • Работайте пачками: создавайте и обновляйте множество задач одним вызовом.
  • Привязывайте код: ссылки на конкретные строки и файлы репозитория.
  • Обсуждайте в тредах: комментарии остаются в контексте задачи.
  • Сохраняйте и переносите проекты: полный экспорт в JSON со всеми связями.

Как подключить

Шаг 1: Установка

Установите пакет глобально: npm install -g saga-mcp. Или запускайте через npx без установки — пакет подтянется автоматически.

Шаг 2: Настройка клиента

Добавьте конфигурацию в вашего MCP-клиента. Для Claude Desktop файл claude_desktop_config.json:

{"mcpServers": {"saga": {"command": "npx","args": ["-y", "saga-mcp"],"env": {"DB_PATH": "/полный/путь/к/папке/.tracker.db"}}}}

Шаг 3: Завершение

Перезапустите клиент. База данных и схема создадутся автоматически при первом обращении к инструменту. Переменная DB_PATH обязательна. Без неё сервер не запустится. Убедитесь, что путь абсолютный.

Примеры запросов

  • «Создай проект „Веб-приложение», добавь эпик „Авторизация» с задачами „Форма входа» и „JWT-токены».
  • «Покажи дашборд проекта и выведи задачи, которые сейчас заблокированы.»
  • «Добавь к задаче „Форма входа» заметку: „Используем OAuth 2.0, обсуждалось на встрече 10.10» и привяжи ссылку на файл src/auth/login.ts.»
  • «Экспортируй проект „Веб-приложение» в JSON и сохрани в /backups/»

Технические детали

  • Язык: TypeScript
  • Хранилище: SQLite (файл .tracker.db)
  • Транспорт: stdio
  • Инструменты: 31 (с аннотациями readOnly и idempotent)
  • Лицензия: MIT
  • Совместимость: Claude Desktop, Claude Code, Cursor, Continue, любой MCP-клиент
  • Платформы: macOS, Windows, Linux

Поделиться