Memory MCP
概要
作者による説明(英語の原文)
Persistent memory + git snapshots for Claude Code. Never lose context or code.
PopNx MCPの3つの柱
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
- 利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
- 私たちの基本チェックi2項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
- 利用状況i初期↓ 128/週 · ★ 100
できること
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
- 接続方法: パソコンで動く
- トランスポート: stdio
- カテゴリ: 検索・AIの記憶
インストール
使っているAIアプリを選んで、設定をコピーしてください。
インストールの前に
- 基本チェック:2項目中1項目に合格
- あなたのパソコンで、あなたのユーザーと同じ権限(ファイル、ネットワーク、アプリ)で動きます。
- レジストリには、入力が必要なキーは載っていません。
必要なもの
- npmNode.jsのインストール(npxコマンドに必要)
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"claude-code-memory"
]
}
}
}ターミナルでこれを実行します
claude mcp add memory -- npx -y claude-code-memoryまたは、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"claude-code-memory"
]
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"memory": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"claude-code-memory"
]
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月10日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント yuvalsuede で確認済みです
- ! 注意
今もメンテナンスされている
コードの最終更新:9 か月前(6か月以上前)
- … 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
検索・AIの記憶のほかのサーバーとの比較i
- このカテゴリのほかの5864件のうち98%よりスターが多い
- このカテゴリのほかの5864件のうち2%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの5864件のうち14%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Memory MCPは安全ですか?
当てはまる基本チェック2項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は9 か月前、最新バージョン(1.2.1)がレジストリに届いたのは9 か月前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
代わりに使えるものは?
同じカテゴリには:Ruflo, Context7, Metabase
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
memory-mcp
Persistent memory + automatic git snapshots for Claude Code. Never lose context. Never lose code.
🧠 45 memories | 📊 2.8K tokens | 📸 23 snapshots | ⏱️ 5m ago
Why memory-mcp?
| Problem | Solution |
|---|---|
| Re-explaining your project every session | Auto-captures decisions, patterns, architecture |
| Context window fills up, knowledge lost | Two-tier memory: CLAUDE.md (instant) + deep search |
| Broke something, can't remember what worked | Git snapshots on every save, instant rollback |
| No idea what Claude "knows" about your project | Visual dashboard shows all context |
| Worried about cloud storage | 100% local files, your git repo |
What makes it different
- Git Snapshots — Every memory save commits your entire project. Roll back anytime.
- Two-Tier Memory — CLAUDE.md loads instantly, deep store searchable mid-conversation.
- LLM-Powered — Haiku extracts what matters, consolidates duplicates, prunes stale info.
- Visual Dashboard — See your context: tokens, memories by type, snapshot history.
- Zero friction — No commands to run. It just works silently.
Quick Start
# Install globally
npm install -g claude-code-memory
Interactive setup (API key + hooks)
memory-mcp setup
Initialize a project
memory-mcp init ~/Projects/my-app
That's it. Start coding. Memories accumulate automatically.
How It Works
graph TB
subgraph "Phase 1: Silent Capture" A[Claude Code Session] -->|User sends message| B[Claude responds] B -->|Hook fires: Stop/PreCompact/SessionEnd| C[extractor.js] C --> D[Read transcript from cursor] D --> E[Chunk if >6000 chars] E --> F[Send to Haiku LLM] F -->|Extract memories as JSON| G[Dedup via Jaccard similarity] G --> H[Save to .memory/state.json] H --> I[Decay confidence scores] I --> J{Consolidation needed?} J -->|>80 memories or every 10 extractions| K[Haiku merges/drops] J -->|No| L[Sync CLAUDE.md] K --> L end
subgraph "Phase 2: Recovery" M[New session starts] -->|Built-in behavior| N[Claude reads CLAUDE.md] N --> O[Claude has full project context] end
subgraph "Phase 3: Deep Recall" O --> P{Need specific context?} P -->|memory_search| Q[Keyword search across memories] P -->|memory_ask| R[Haiku synthesizes answer from top 30 matches] P -->|memory_related| S[Tag-based retrieval] end
subgraph "Data Store" H -.-> T[(.memory/state.json Full memory store)] L -.-> U[(CLAUDE.md ~150 line summary)] T -.->|MCP tools read| Q T -.->|MCP tools read| R T -.->|MCP tools read| S end
style A fill:#4a9eff,color:#fff style F fill:#ff6b6b,color:#fff style K fill:#ff6b6b,color:#fff style R fill:#ff6b6b,color:#fff style T fill:#ffd93d,color:#000 style U fill:#6bcb77,color:#000
Two-tier memory architecture:
| Layer | Purpose | Size |
|---|---|---|
CLAUDE.md | Auto-read on session start. Top ~150 lines of the most important context. | Compact |
.memory/state.json | Full memory store. Searchable via MCP tools mid-conversation. | Unlimited |
Silent capture via hooks:
Claude Code hooks fire after every response (Stop), before context compaction (PreCompact), and at session end (SessionEnd). A fast LLM (Haiku) reads the transcript and extracts:
- Architecture — how the system is structured
- Decisions — why X was chosen over Y
- Patterns — conventions and how things are done
- Gotchas — non-obvious pitfalls
- Progress — what's done, what's in flight
- Context — business context, deadlines, preferences
Smart memory management:
- Jaccard similarity deduplication (no duplicate memories)
- Confidence decay (progress fades after 7 days, context after 30)
- LLM-powered consolidation (merges overlapping memories, prunes stale ones)
- Line-budgeted CLAUDE.md (stays under ~150 lines, most important first)
Updating
To update an existing installation:
npm install -g claude-code-memory --force
To update hooks (e.g., after a bug fix):
memory-mcp setup
Requirements
- Claude Code CLI
- Node.js 18+
- Anthropic API key (for the Haiku-based extractor, ~$0.001 per extraction)
CLI Commands
memory-mcp setup Interactive first-time setup
memory-mcp init [dir] Initialize memory for a project memory-mcp status [dir] Show memory status and health memory-mcp statusline [dir] Compact one-line status (great for shell prompts) memory-mcp context [dir] Show context metrics and token usage memory-mcp context --html Generate visual HTML dashboard memory-mcp search Search memories by keyword memory-mcp ask Ask a question, get answer from memory memory-mcp consolidate [dir] Merge duplicates, prune stale memories memory-mcp key [api-key] Set or check Anthropic API key memory-mcp snapshots [dir] List git snapshot history memory-mcp snapshot-enable Enable automatic git snapshots memory-mcp snapshot-disable Disable git snapshots memory-mcp help Show help
Context Dashboard
Visualize your memory usage with memory-mcp context:
Context Dashboard
Project: my-app
Total Context 2.8K estimated tokens
Tier 1 CLAUDE.md (auto-loaded) █████████████████░░░░░░░░░░░░░ 1.0K 45 lines, 44 in memory block
Tier 2 .memory/state.json (searchable) ██████████████████████████████ 1.8K 29 active, 5 archived, 24 superseded
Memories by Type architecture ███░░░░░░░░░░░░░░░░░ 8 memories (291 tokens) decision ██████░░░░░░░░░░░░░░ 18 memories (540 tokens) gotcha ████░░░░░░░░░░░░░░░░ 10 memories (332 tokens) progress ██████░░░░░░░░░░░░░░ 19 memories (538 tokens)
Git Snapshots ● Enabled on __memory-snapshots 42 commits → origin
Use memory-mcp context --html to generate an interactive browser dashboard.
Git Snapshots
Automatic project versioning tied to your working sessions. Every memory extraction commits your entire project to a hidden branch.
# Enable during init (you'll be prompted)
memory-mcp init ~/Projects/my-app
Or enable later
memory-mcp snapshot-enable
View snapshot history
memory-mcp snapshots
Compare two snapshots
memory-mcp snapshot-diff abc123 def456
Restore to a previous state
memory-mcp snapshot-restore abc123
Disable (preserves existing snapshots)
memory-mcp snapshot-disable
How it works:
- Commits go to
__memory-snapshotsbranch (invisible in normal workflow) - Optional push to remote (e.g., origin)
- Commit messages include what memories were extracted
- Full project state captured, not just memory files
Use cases:
- Roll back after breaking changes
- See what your project looked like during a specific session
- Track project evolution alongside context evolution
MCP Tools (used by Claude mid-conversation)
When configured as an MCP server, Claude can access these tools during a session:
| Tool | Description |
|---|---|
memory_search | Keyword search across all memories |
memory_related | Get memories by tag or area |
memory_ask | Ask a question, get an LLM-synthesized answer from memory |
memory_save | Manually save a memory |
memory_recall | List all memories with filters |
memory_delete | Remove a memory |
memory_consolidate | Trigger memory consolidation |
memory_consciousness | Generate the full consciousness document |
memory_stats | Show memory statistics |
memory_init | Set project name and description |
What Gets Stored
Memories are categorized into six types:
architecture "Next.js 14 app router with Supabase backend, Stripe for billing"
decision "Chose server components for public pages because of SEO requirements" pattern "All API routes validate input with zod and return NextResponse" gotcha "Supabase RLS policy on word_lists requires user_id OR org_id, not both" progress "Auth complete, billing webhook handling in progress" context "Client wants launch by March, focus on core features only"
File Structure
After initialization, your project gets:
your-project/
├── CLAUDE.md ← auto-updated memory summary (read on session start) ├── .memory/ │ ├── state.json ← full memory store │ └── cursor.json ← tracks what's been processed ├── .mcp.json ← MCP server configuration └── .claude/ └── settings.json ← hook configuration
CLAUDE.md Format
The memory block is inserted between markers, preserving any existing CLAUDE.md content:
<!-- MEMORY:START -->
MyProject
A brief description
_Last updated: 2026-01-27 | 45 active memories, 62 total_
Architecture
- Next.js 14 app router with Supabase backend
- Auth via NextAuth with Google and email providers
Key Decisions
- Chose server components for SEO pages
- Using Supabase RLS instead of API-level auth
Patterns & Conventions
- All API routes use zod validation
- Tailwind only, no CSS modules
Gotchas & Pitfalls
- RLS policy requires user_id OR org_id, not both
Current Progress
- Auth: complete
- Billing: in progress
Context
- Launch target: March
_For deeper context, use memory_search, memory_related, or memory_ask tools._
Global vs Per-Project Install
Global (recommended): hooks work for all projects automatically.
memory-mcp setup # select "global" when prompted
Per-project: hooks and MCP configured per project.
memory-mcp init /path/to/project
Configuration
API key is resolved in order:
ANTHROPIC_API_KEYenvironment variable~/.memory-mcp/config.json~/.config/anthropic/api_key~/.anthropic/api_key
Cost
The extractor uses Claude Haiku for memory extraction and consolidation. Typical cost:
- ~$0.001 per extraction (after each Claude response)
- ~$0.005 per consolidation (every ~10 extractions)
- A full day of coding: ~$0.05–0.10
License
MIT