State Memory MCP

by putervision

Not rated
GitHub

About

Persistent, branch-aware workflow state memory MCP server for AI coding assistants. Tracks tasks, accepted decisions, and active blockers to prevent session context bloat and speed up development.

Details

Author
putervision
Categories
AI

Setup

Install State Memory MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/putervision/state-memory-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

@putervision/state-memory-mcpis a zero-infrastructure, deterministic Model Context Protocol (MCP) server that provides AI coding assistants (such as Cursor, Claude Code, Gemini, or Copilot) with a structured, persistent SQLite graph for tracking workflow state—tasks, decisions, artifacts, plans, blockers, and their semantic relationships.

🌐Official Documentation & Website:statememorymcp.com

# 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

- 🧠 Deterministic State Memory: Zero LLM in the loop for memory operations; fast, deterministic SQLite graph traversals.
- ⚡ 82 Core MCP Tools: Full CRUD, relationship linking, DAG cycle checks, FTS5 search, TF-IDF RAG, time-travel history rollback, Spec-Driven Development, and auto-healing validation.
- 📉 Efficient Context Management: Offloads context to a local SQLite database, helping reduce prompt context bloat and context window usage.
- 🚀 67%–74% Latency Reduction: Eliminates multi-step file scanning loops; agents retrieve unblocked tasks and blockers in milliseconds.
- 🤝 Multi-Agent Blackboard: Shared Context Store allowing parallel subagents to publish decisions, tasks, and blocker updates safely.
- 🎨 Interactive 3D Visualizer: Browser-based dark-mode 3D WebGL force-directed graph visualizer (state-memory-mcp view).
- 🛡️ 100% Local & Private: Local-first architecture; all state stays inside.state-memory-mcp/in your workspace.

Explore dedicated guides and deep dives in thedocs/directory:

# Run full unit, integration, and performance benchmark test suite npm run test

Developed and maintained byPuterVision LLC. Released under theMIT License.

- Local Storage Guarantee: All graph data, decision records, and event logs remain 100% local in your workspace. No telemetry or project data is ever transmitted.
- Trademarks & Non-Affiliation: Product names (Cursor, Claude Code, Gemini, Windsurf, VS Code, GitHub, SQLite) are property of their respective owners and used solely for compatibility identification.

Local-first agent memory: a plain-Markdown Obsidian vault is the source of truth, with a rebuildable DuckDB index for hybrid BM25 + vector + graph recall.

Persistent memory and semantic search for AI coding assistants across sessions

Give your agent a memory: shared, cited, tenant-isolated knowledge-graph memory for any MCP host. Grounded answers from a local-first June endpoint — abstains rather than guesses.

Decentralized persistent memory for AI agents — encrypted vault storage built on Walrus and Sui.

Persistent memory for AI assistants and coding agents across ChatGPT, Claude, Cursor, and other MCP-compatible tools.

Your portable AI memory vault — memories, skills & configs, shared across every AI tool.

Local Work Model for AI agents that learns from real outcomes.

Adaptive MCP memory system for AI applications. Learns which retrieval strategies work for your data, scores results using cognitive science models, builds a knowledge graph automatically, and validates every parameter change against real query history before adopting it. Patent pending.

Auditable, self-improving knowledge & memory for AI agents over MCP — citation-enforced answers and a replayable why-trace, self-hosted on Postgres.

Turns your task manager into agent memory: hybrid (RRF) retrieval over TickTick or an Obsidian vault via an adapter contract. MCP server + CLI, no vector DB to maintain.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.