@putervision/state-memory-mcp

@putervision/state-memory-mcp — это детерминированный сервер Model Context Protocol (MCP), не требующий инфраструктуры, который предоставляет AI-ассистентам для написания кода (таким как Cursor, Claude Code, Gemini или Copilot) структурированный постоянный граф на основе SQLite для отслеживания состояния рабочего процесса — задач, решений, артефактов, планов, блокеров и их семантических связей.

🌐 Официальная документация и веб-сайт: statememorymcp.com

⚡ Быстрый старт и установка

Предварительные требования: Node.js >= 18.18.0

# 1. Install globally
npm install -g @putervision/state-memory-mcp

# 2. Navigate to your project directory
cd your-project

# 3. Initialize state-memory-mcp
# Creates .state-memory-mcp/, updates .gitignore, registers project,
# and scaffolds IDE instructions and MCP configs for Cursor, Claude, VS Code, Windsurf, etc.
state-memory-mcp init

# Done! Restart your IDE or Agent Manager to activate.

Альтернативные варианты

# Run directly via binary (after global install)
state-memory-mcp run

# Re-initialize across all registered workspace projects
state-memory-mcp init-global

Related MCP server: AIVectorMemory

🌟 Ключевые особенности

• 🧠 Детерминированная память состояния: операции с памятью выполняются без участия LLM в цикле; быстрые детерминированные обходы графа на базе SQLite.

• ⚡ 13 консолидированных MCP-инструментов промышленного уровня: полный CRUD, установление связей, проверка на наличие циклов в DAG, полнотекстовый поиск FTS5, TF-IDF RAG, откат истории с перемещением во времени (time-travel), Spec-Driven Development и самовосстанавливающаяся валидация.

• 📉 Эффективное управление контекстом: выгрузка контекста в локальную базу данных SQLite, что помогает уменьшить раздувание контекста промпта и расход контекстного окна.

• 🚀 Снижение задержки на 67–74%: устраняет многошаговые циклы сканирования файлов; агенты получают разблокированные задачи и блокеры за миллисекунды.

• 🤝 Мультиагентный Blackboard: общее хранилище контекста, позволяющее параллельным субагентам безопасно публиковать решения, задачи и обновления блокеров.

• 🎨 Интерактивный 3D-визуализатор: браузерный 3D-визуализатор графа с силовой раскладкой на WebGL и тёмной темой (state-memory-mcp view).

• 🔗 Синергия двух MCP-серверов: работайте в паре с @putervision/vision-memory-mcp для кэширования визуального состояния, перцептивного хеширования и криптографических мультимодальных пакетов доказательств.

• 🛡️ 100% локально и конфиденциально: архитектура local-first; все состояние остается внутри .state-memory-mcp/ в вашем рабочем пространстве.

🛠️ Набор MCP-инструментов

@putervision/state-memory-mcp предоставляет 13 консолидированных MCP-инструментов промышленного уровня, организованных по 5 основным областям рабочего процесса:

• Граф и связи: manage_nodes (CRUD узлов, векторный поиск FTS5/TF-IDF, атомарные пакетные изменения, заметки наблюдений), manage_edges (типизированные связи DAG, мультимодальное связывание визуальных состояний).

• Выполнение задач и очередь работ: manage_tasks (топологическая очередь зависимостей, обнаружение блокеров, завершение задач с артефактами, автоматическая очистка), manage_sessions (атрибуция агентов, отслеживание ходов, начальная загрузка контекста).

• Spec-Driven Development (SDD): manage_specs (разбор PRD/RFC, декомпозиция требований в задачи, проверка критериев приемки в реальном времени, оценка соответствия).

• Аналитика, аудит и диагностика: get_analytics (velocity, burndown, ROI токенов, когнитивная нагрузка, критический путь), get_events (журнал событий на SHA-256 с защитой от подделки), run_diagnostics (валидация DAG, проверки работоспособности, целостность ссылок AST).

• Данные, снимки и мультиагентность: manage_snapshots (контрольные точки, отмена через time-travel), manage_database (резервные копии, проверки контрольных сумм, слияние веток VCS), manage_data (массовый импорт/экспорт, ML-траектории), query_graph (подграфы, трассировка зависимостей, сырой SQL), use_blackboard (асинхронная мультиагентная доска тем).

👉 Полные спецификации параметров, возвращаемые схемы и примеры полезных нагрузок см. в Tools Reference Guide и Formal API Reference.

🚀 Архитектура и жизненный цикл графа состояния

                      AI Agent Prompt / Task
                                │
                                ▼
               ┌─────────────────────────────────┐
               │  Agent Session Attribution       │ ──▶ manage_sessions(action: "start")
               └────────────────┬────────────────┘
                                │
                                ▼
               ┌─────────────────────────────────┐
               │  Context & Task Prioritization   │ ──▶ get_analytics(action: "summary")
               │                                 │ ──▶ manage_tasks(action: "next")
               └────────────────┬────────────────┘
                                │
                                ▼
               ┌─────────────────────────────────┐
               │  Deterministic Graph Mutation   │ ──▶ manage_nodes(action: "create"|"update")
               │  (Tasks, Decisions, Blockers)   │ ──▶ manage_edges(action: "add"|"link_visual")
               └────────────────┬────────────────┘
                                │
                                ▼
               ┌─────────────────────────────────┐
               │  Spec & Integrity Verification  │ ──▶ manage_specs(action: "compliance"|"verify")
               │                                 │ ──▶ run_diagnostics(action: "validate")
               └────────────────┬────────────────┘
                                │
                                ▼
               ┌─────────────────────────────────┐
               │  Persistent SQLite Storage      │ ──▶ .state-memory-mcp/graph.db (WAL mode)
               │  Append-Only Event Ledger       │ ──▶ SHA-256 Cryptographic Audit Chain
               └─────────────────────────────────┘

📚 Каталог документации

Изучите специализированные руководства и подробные разборы в каталоге docs/:

📖 Плейбук агента: канонический рабочий процесс из 5 шагов

Когда автономный AI-агент попадает в репозиторий с state-memory-mcp:

1. Orient & Bootstrap ──▶ manage_sessions(action: "start") + get_analytics(action: "summary")
2. Task Selection     ──▶ manage_tasks(action: "next") + manage_tasks(action: "find_blockers")
3. Trace Context      ──▶ query_graph(action: "trace") + manage_specs(action: "compliance")
4. Execute & Record   ──▶ manage_nodes(action: "create", type: "decision") + manage_edges(action: "link_visual")
5. Validate & Close   ──▶ run_diagnostics(action: "validate") + manage_tasks(action: "complete") + manage_sessions(action: "end")

🧪 Тестирование

# Run full unit, integration, and performance benchmark test suite across all 110 test files (406 tests)
npm run test

⚖️ Лицензия и отказ от ответственности

Разработано и сопровождается компанией PuterVision. Распространяется под лицензией MIT License.

• Гарантия локального хранения: все данные графа, записи решений и журналы событий остаются на 100% локальными в вашем рабочем пространстве. Никакая телеметрия или данные проекта никогда не передаются.

• Товарные знаки и отсутствие аффилированности: названия продуктов (Cursor, Claude Code, Gemini, Windsurf, VS Code, GitHub, SQLite) являются собственностью соответствующих владельцев и используются исключительно для указания совместимости.