프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. 리뷰와 계정 기능은 다음 단계에서 열려요.
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요
초보자 모드 켜기
색상시스템 설정라이트다크
언어ไทยEnglish中文日本語한국어EspañolDeutsch
☰ 메뉴설정
초보자 모드 켜기
색상시스템 설정라이트다크
언어ไทยEnglish中文日本語한국어EspañolDeutsch

State Memory MCP

제작자: putervision버전 1.4.1i★ –i내 컴퓨터에서 실행
레지스트리 이름io.github.putervision/state-memory-mcp

설치

개요

제작자가 쓴 설명(영어 원문)

Persistent workflow graph server tracking tasks, decisions, spatial entities, and blockers.

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

  • 연결 방식: 내 컴퓨터에서 실행
  • 전송 방식: stdio
  • 카테고리: 검색 및 AI 기억

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

  • 기본 점검: 1개 중 1개 통과
  • 내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
  • 레지스트리에 입력해야 할 키가 나와 있지 않아요.

필요한 것

  • npmNode.js 설치(npx 명령어용)

어떤 앱을 쓰세요?

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요

{
  "mcpServers": {
    "state-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@putervision/state-memory-mcp"
      ]
    }
  }
}

터미널에서 이 명령어를 실행하세요

claude mcp add state-memory -- npx -y @putervision/state-memory-mcp

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

{
  "mcpServers": {
    "state-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@putervision/state-memory-mcp"
      ]
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

{
  "servers": {
    "state-memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@putervision/state-memory-mcp"
      ]
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 6일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 GitHub 계정 putervision 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요

  • … 아직 점검 안 함

    계속 관리되고 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • … 아직 점검 안 함

    라이선스 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • – 해당 없음

    엔드포인트 응답

    내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요

  • – 해당 없음

    OAuth로 로그인

    내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요

  • … 아직 점검 안 함

    도구 설명에 숨겨진 지시 없음

    내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

검색 및 AI 기억 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 7243개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 7243개 중 53%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 7243개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

State Memory MCP, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(1.4.1)은 34일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Context7, Codebase Memory, Exa

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Context7

제작자: upstash

Up-to-date docs for AI agents

컴퓨터 또는 클라우드★ 64,224MIT3일 전 업데이트
설치

Codebase Memory

제작자: DeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

내 컴퓨터에서 실행★ 48,148MIT20일 전 업데이트
설치

Exa

제작자: exa-labs

Connect AI agents to Exa for web search, content fetching, and multi-step research.

클라우드에서 실행★ 5,213MIT44일 전 업데이트
설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

@putervision/state-memory-mcp

@putervision/state-memory-mcp is 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

⚡ Quick Start & Installation

Prerequisites: 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.

Alternative Options
# Run directly via binary (after global install)

state-memory-mcp run

Re-initialize across all registered workspace projects

state-memory-mcp init-global

🌟 Key Highlights

  • 🧠 Deterministic State Memory & Compact TaskSlices: Zero LLM in the loop for memory operations; fast, deterministic SQLite graph traversals, and sub-1KB TaskSlice extraction for System 1 fast path evaluation.
  • ⚡ 13 Production-Grade Consolidated 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 & Decision Thresholding: Offloads context to a local SQLite database, filters sub-0.70 routine decisions to append-only event logs to prevent graph bloat, and preserves high-significance turns.
  • 🚀 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).
  • 🔗 Dual-MCP Synergy: Pair with @putervision/vision-memory-mcp for visual state caching, perceptual hashing, and cryptographic multimodal evidence packs.
  • 🛡️ 100% Local & Private: Local-first architecture; all state stays inside .state-memory-mcp/ in your workspace.

🛠️ MCP Tool Suite

@putervision/state-memory-mcp provides 13 production-grade consolidated MCP tools organized across 5 core workflow domains:

  • Graph & Relationships: manage_nodes (node CRUD, FTS5/TF-IDF vector search, atomic batch mutations, observation notes, thresholded fast decision logging), manage_edges (typed DAG links, multimodal visual state linking).
  • Task Execution & Work Queue: manage_tasks (topological dependency queue, blocker detection, task completion with artifacts, auto-prune), manage_sessions (agent attribution, turn tracking, context bootstrap).
  • Spec-Driven Development (SDD): manage_specs (PRD/RFC parsing, requirement-to-task decomposition, live acceptance criteria verification, compliance scoring).
  • Analytics, Audit & Diagnostics: get_analytics (velocity, burndown, token ROI, cognitive load, critical path), get_events (SHA-256 tamper-evident event ledger), run_diagnostics (DAG validation, health checks, AST reference integrity).
  • Data, Snapshots & Multi-Agent: manage_snapshots (checkpoints, time-travel undo), manage_database (backups, checksum audits, VCS branch merge), manage_data (bulk import/export, ML trajectories with interleaved fast decision events), query_graph (subgraphs, dependency tracing, raw SQL, sub-1KB compact_slice), use_blackboard (multi-agent asynchronous topic board).

👉 For complete parameter specifications, return schemas, and example payloads, see the [Tools Reference Guide](docs/tools-reference.md) and [Formal API Reference](docs/api-reference.md).

🚀 Architecture & State Graph Lifecycle

                      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 └─────────────────────────────────┘

📚 Documentation Directory

Explore dedicated guides and deep dives in the docs/ directory:

GuideDescription
🏗️ [Architecture & Codebase Distillation](docs/codebase-distillation.md)High-signal architectural overview, module inventory, data flows, and design decisions.
🚀 [v0.10 → v1.0 Migration Guide](MIGRATION.md)Step-by-step migration guide, legacy tool mapping table, and STATE_MEMORY_COMPAT mode.
💡 [Value Proposition & Theory](docs/value-proposition.md)Cognitive Externalization, FSM Formalism, First-Hop Determinism & Benchmark metrics.
📋 [State Memory Concepts](docs/concepts.md)Node Types (task, decision, blocker...), Status Values, Typed Edges & Seeding Guidelines.
⚙️ [Configuration & IDE Setup](docs/configuration.md)Auto-Initialization details, Environment Variables table, and Editor Configs (Cursor, VS Code, Claude, Antigravity, Windsurf).
🛠️ [CLI Command Reference](docs/cli-usage.md)CLI flags (init, run, view, inspect, metrics, audit, doctor, backup, restore, merge) & Git Scanner.
⏱️ [Sessions, Snapshots & SDD](docs/session-management.md)Session Lifecycle, Event Audit Trail, Snapshots, Trajectories, Sub-directory support & Spec-Driven Development.
🧰 [Tools, Resources & Prompts](docs/tools-reference.md)Complete reference for all 13 Consolidated MCP Tools, read-only state-memory:/// Resources, and Prompt templates.
📘 [Formal API Reference](docs/api-reference.md)Formal parameters, return schemas, and code signatures for all MCP endpoints.
🎨 [3D Visualizer Guide](docs/visualizer.md)Viewing and exporting the interactive WebGL 3D Force-Directed Graph visualizer.
🗄️ [Database Schema](docs/database-schema.md)SQLite tables, columns, indexes, and schema migration history.

📖 Agent Playbook: 5-Step Canonical Workflow

When an autonomous AI agent enters a repository with state-memory-mcp:

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

🧪 Testing

# Run full unit, integration, and performance benchmark test suite across all 113 test files (418 tests)

npm run test

⚖️ License & Disclaimers

Developed and maintained by PuterVision. Released under the MIT 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.
PopNx에게 묻기