@putervision/state-memory-mcp 是一个零基础设施、确定性的模型上下文协议（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-globalRelated MCP server: AIVectorMemory
🧠 确定性状态记忆：记忆操作全程无 LLM 参与；快速、确定性的 SQLite 图遍历。
⚡ 13 个生产级整合式 MCP 工具：完整的 CRUD、关系链接、DAG 循环检测、FTS5 搜索、TF-IDF RAG、时间旅行历史回滚、规范驱动开发及自愈式校验。
📉 高效上下文管理：将上下文卸载到本地 SQLite 数据库，帮助减少提示词上下文膨胀和上下文窗口占用。
🚀 降低 67%–74% 延迟：消除多步文件扫描循环；智能体可在毫秒级检索到未阻塞任务和阻塞项。
🤝 多智能体黑板：共享 Context 存储，允许并行子智能体安全地发布决策、任务和阻塞项的更新。
🎨 交互式 3D 可视化器：基于浏览器的深色模式 3D WebGL 力导向图可视化器（state-memory-mcp view）。
🔗 双 MCP 协同：与 @putervision/vision-memory-mcp 搭配使用，实现视觉状态缓存、感知哈希和加密多模态证据包。
🛡️ 100% 本地与隐私：本地优先架构；所有状态均保留在工作区的 .state-memory-mcp/ 目录中。
@putervision/state-memory-mcp 提供 13 个生产级整合式 MCP 工具，覆盖 5 个核心工作流领域：
图与关系：manage_nodes（节点 CRUD、FTS5/TF-IDF 向量搜索、原子批量变更、观测笔记）、manage_edges（类型化 DAG 链接、多模态可视化状态链接）。
任务执行与工作队列：manage_tasks（拓扑依赖队列、阻塞项检测、完成任务并关联制品、自动清理）、manage_sessions（智能体属性、轮次跟踪、上下文引导）。
规范驱动开发（SDD）：manage_specs（PRD/RFC 解析、需求到任务的分解、实时验收标准验证、符合度评分）。
分析、审计与诊断：get_analytics（速度、进度消耗、Token ROI、认知负担、关键路径）、get_events（SHA-256 防篡改事件账本）、run_diagnostics（DAG 验证、健康检查、AST 引用完整性）。
数据、快照与多智能体：manage_snapshots（检查点、时间旅行撤销）、manage_database（备份、校验和审计、VCS 分支合并）、manage_data（批量导入/导出、ML 轨迹）、query_graph（子图、依赖追踪、原生 SQL）、use_blackboard（多智能体异步主题黑板）。
👉 如需完整的参数规范、返回结构和示例载荷，请参阅 工具参考指南 和 正式 API 参考。
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/ 目录中的专项指南和深入解析：
指南 | 描述 |
🏗️ 架构与代码库浓缩 | 高信号量级的架构概述、模块清单、数据流与设计决策。 |
逐步迁移指南、旧版工具映射表，以及 | |
💡 价值主张与理论 | 认知外部化、FSM 形式化、首跳确定性与基准指标。 |
📋 状态记忆概念 | 节点类型（ |
⚙️ 配置与 IDE 设置 | 自动初始化细节、环境变量表及编辑器配置（Cursor、VS Code、Claude、Antigravity、Windsurf）。 |
🛠️ CLI 命令参考 | CLI 标志（ |
⏱️ 会话、快照与 SDD | 会话生命周期、事件审计线索、快照、轨迹、子目录支持与规范驱动开发。 |
🧰 工具、资源与提示模板. | 全部 13 个整合式 MCP 工具的完整参考、只读 |
所有 MCP 端点的正式参数、返回结构及代码签名。 | |
查看并导出交互式 WebGL 3D 力导向图可视化器。 | |
🗄️ 数据库 Schema | SQLite 表、列、索引及结构迁移历史。 |
当自主 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](https://putervision.com）开发与维护。以 MIT License 发布。
本地存储保证：所有图数据、决策记录和事件日志均 100% 保存在你的工作区中，绝不传输任何遥测信息或项目数据。
商标与非隶属于声明：产品名称（Cursor、Claude Code、Gemini、Windsurf、VS Code、GitHub、SQLite）归各自所有者所有，仅用于兼容性标识。
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Persistent memory and cross-session learning for AI coding assistants (hosted remote MCP).
Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.
Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/putervision/state-memory-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server