Memorix (MCP server) — ユースケース, インストール & ライブデモ

なぜ使うのか

主な機能

クロスエージェント：Claude Code・Cursor・Codex・Windsurf・Gemini CLI・OpenCode・Antigravity・Traeに対応
リビジョン履歴付きの追記専用
タグベースの想起（プロジェクト・言語・決定）
ローカルSQLiteバックエンド；オプションでクラウド同期
小さい — Nodeの単一バイナリ
MIT

ライブデモ

実際の動作

memorix-mcp.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "memorix-mcp",
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "memorix-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "memorix"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add memorix-mcp -- npx -y memorix

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： Memorix

書き直しなしにすべてのコーディングエージェントでプロジェクト規約を共有する

👤 複数のAIコーディングツールを使う開発者 ⏱ ~15 min beginner

使うタイミング： Cursor・Claude Code・Codexに同じモノリポのレイアウトを初日に説明して、どれが何を知っているか分からなくなる場合。

前提条件

Memorixの実行 — npx memorix — デフォルトは~/.memorix.db

フロー

メモリをシードする

Save these facts about my project: package manager pnpm, runtime node 22, db postgres 16, auth in /apps/api/src/auth (not /legacy/auth).✓ コピーしました

→ タグ付きで5件のメモリが追記される
別のエージェントで想起する

(in Cursor with same Memorix) — What conventions are set for this project?✓ コピーしました

→ 同じ5件のメモリが返される
1件を更新する

Update memory: now using node 24 (was 22). Keep history.✓ コピーしました

→ 更新済み；履歴がリビジョンとして保持

結果： プロジェクトのコンテキストがエージェントをまたいで、日をまたいで持続する。

注意点

メモリが古くなる — decayで古いメモリに低信頼度を付けてください；エージェントはそれに応じて重み付けします

アーキテクチャの決定をクエリ可能なメモリとして記録する

👤 テックリード、スタッフエンジニア ⏱ ~20 min intermediate

使うタイミング： 「Reduxは使わない、zustendだけ」という決定を定着させたい場合。

フロー

決定を記録する

Save decision: 'Use zustand, not Redux. Reason: simpler API, smaller bundle.' Tag: state-management.✓ コピーしました

→ タグ付きで決定が保存される
強制を確認する

Whenever Claude is about to import redux in this repo, reject and quote the decision.✓ コピーしました

→ その後のインポートが保存された理由とともにフラグが立てられる

結果： エージェントが実際に読む、軽量なADRログ。

注意点

Memorixはユーザーごと；チーム全体のADRにはクラウド同期またはチェックイン済みのミラーが必要 — --export ./adr.jsonを使用してコミットし；チームメンバーは--importで同期

組み合わせ： github

デバッグセッションを別のエージェントに引き継ぐ

👤 タスク途中でモデルを切り替える開発者 ⏱ ~10 min intermediate

使うタイミング： Claudeが2時間デバッグしていて、すべてを再説明せずにCodexに切り替えたい場合。

フロー

スナップショットを取る

Snapshot current debugging context: hypothesis, what we ruled out, next step.✓ コピーしました

→ タグdebug-session-<id>付きでスナップショットが保存される
別の場所で引き継ぐ

(in Codex) — Load debug session and continue from where Claude left off.✓ コピーしました

→ Codexがスナップショットを要約して次のステップを提案

結果： スムーズなタスク途中のエージェント切り替え。

注意点

スナップショットが曖昧すぎて新しいエージェントがゼロから再開する — Memorixのスナップショットツールは仮説・証拠・次のステップを促します — 3つすべて記入してください

組み合わせ

他のMCPと組み合わせて10倍の力を

memorix-mcp + github

メモリをチーム共有のadr.jsonファイルにミラーする

Export memories tagged 'adr' to /docs/adr.json and commit.✓ コピーしました

memorix-mcp + filesystem

ローカルMemorix DBをバックアップする

Copy ~/.memorix.db to /backups/$(date +%F)/.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
save	content: str, tags: str[]	ファクト / 決定 / スナップショットを永続化する	free
recall	query?, tags?, limit?	現在のタスクに関連するコンテキストを取り込む	free
update	id, content	既存のメモリを修正または改善する	free
decay	older_than_days	定期的なクリーンアップ	free

コストと制限

運用コスト

APIクォータ: ローカルSQLite — ディスクに依存
呼び出しあたりのトークン: 想起あたり100〜500
金額: 無料；クラウド同期（使用する場合）は様々
ヒント: 想起クエリが最近の密なコンテキストを返すよう、週次でdecayを実行してください（6ヶ月前のデバッグメモでなく）

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： デフォルトはローカルSQLite；クラウド同期にはAPIキーが必要

データ送信先： デフォルトはローカルのみ

メモリにはシークレットが含まれる場合があります（例：「APIキーXYZを使用」）— エクスポート/コミット前に確認してください

トラブルシューティング

よくあるエラーと対処法

想起で関連するものが返らない

タグが一致しているか確認してください — Memorixはタグフィルターとファジーテキストの両方を使用

確認： フィルターなしで実行してすべてのメモリを確認

DBロックエラー

複数のエージェントが同時に書き込んでいます — MemorixはWALを使用；バージョン >= 0.4を確認してください

インポートが失敗する

エクスポートバージョンとインポートバージョンのスキーマが一致しない — 両方を先にアップグレードしてください

代替案

Memorix 他との比較

代替案	代わりに使う場面	トレードオフ
doobidoo/mcp-memory-service	ナレッジグラフや統合などのより豊富な機能が欲しい場合	重い；Memorixは意図的にミニマル
OpenAI Memory / Anthropic Memory	1つのプロバイダーだけを使用する場合	そのプロバイダーにロックイン；Memorixはクロスエージェント

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る