🧠 Prism MCP — AIエージェントのための「記憶の宮殿」

AIエージェントはセッションのたびにすべてを忘れてしまいます。Prismはそれを解決し、さらに「思考」する方法を教えます。

Prism v9.0は、AIエージェントのための自律型認知OSです。人間の脳のメカニズムに触発された真の認知アーキテクチャに基づいて構築されたPrismは、エージェントに感情タグ付きの記憶、トークン経済的なコスト意識、マルチホップグラフ推論を提供します。エージェントは記憶を横断して因果関係のある思考を追い、経験から原則を形成し、保存する情報を最適化し、情報が不足しているときを認識できるようになります。あなたのエージェントは、ただ記憶するだけでなく、思考するようになります。

npx -y prism-mcp-server

Claude Desktop · Claude Code · Cursor · Windsurf · Cline · Gemini · Antigravity など、あらゆるMCPクライアントで動作します。

目次

• なぜPrismなのか？

• クイックスタート

• 魔法の瞬間

• セットアップガイド

• ユニバーサルインポート：履歴の取り込み

• Prismが他と違う理由

• 自律型認知OS (v9.0)

• シナプスエンジン (v8.0)

• 認知アーキテクチャ (v7.8)

• データプライバシーとエグレス

• ユースケース

• 新機能

• Prismの比較

• ツールリファレンス

• 環境変数

• アーキテクチャ

• 科学的基盤

• マイルストーンとロードマップ

• エンタープライズおよび商用サポート

• トラブルシューティングFAQ

なぜPrismなのか？

AIコーディングアシスタントとの会話を新しく始めるたびに、ゼロからのスタートになります。アーキテクチャを再説明し、決定事項を再記述し、TODOリストを再作成する。何時間分ものコンテキストが消えてしまいます。

Prismは、永続的な脳をエージェントに与え、推論する方法を教えます。 各セッションの終わりに重要なことを保存し、次回のセッションで即座に読み込みます。しかし、Prismは単なるストレージを超えています。生の経験を永続的な原則に統合し、因果関係の連鎖をたどって根本原因を浮き彫りにし、「わからない」と言うべきときを認識します。

📌 用語: 本ドキュメント全体を通して、**「Prism」はMCPサーバーと認知メモリエンジンを指します。「Mind Palace（記憶の宮殿）」**はlocalhost:3000で動作する視覚的なダッシュボードUIを指し、エージェントの脳を覗く窓となります。これらは連携して動作しますが、ダッシュボードはオプションです。

Prismには3つの柱があります：

1. 🧠 認知メモリ — 記憶は人間の脳のようにランク付けされます。最近および頻繁にアクセスされたコンテキストが最初に浮上し、古いコンテキストはACT-Rの活性化減衰を通じて自然に消えていきます。生の経験はヘブ学習を通じて意味のある原則へと統合されます。その結果、フラットなベクトル検索では到達できない検索品質が実現します。(「認知アーキテクチャ」および「科学的基盤」を参照)

2. ⚡ シナプスエンジン (GraphRAG) — エージェントが「エラーX」を検索するとき、シナプスエンジンは単に「エラーX」に言及しているログを見つけるだけではありません。マルチホップのエネルギー伝播が因果グラフをたどり（ファン効果によって減衰し、側方抑制によって制限されます）、「アーキテクチャ決定Z」に関連する「回避策Y」を浮上させます。グラフ探索によってのみ発見されたノードには[🌐 Synapse]タグが付けられるため、エンジンの動作を確認できます。(「シナプスエンジン」を参照)

3. 🏭 自律実行 (Dark Factory) — 準備ができたら、Prismはエンドツーエンドでコーディングタスクを実行できます。敵対的評価者がジェネレーターが見逃したバグをPRを見る前にキャッチする、フェイルクローズ型のパイプラインです。(「Dark Factory」を参照)

クイックスタート

前提条件

• Node.js v18+ (v20 LTS推奨; v23.xには既知のnpxの癖があります)

• MCP互換クライアント (Claude Desktop, Cursor, Windsurf, Clineなど)

• コア機能にAPIキーは不要 (「機能マトリックス」を参照)

インストール

MCPクライアントの設定ファイル (claude_desktop_config.json, .cursor/mcp.jsonなど) に追加します：

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

⚠️ Windows / 制限付きシェル: MCPクライアントがnpxが見つからないと警告する場合は、ノードバイナリへの絶対パスを使用してください (例: C:\Program Files\nodejs\npx.cmd)。

以上です。 クライアントを再起動してください。すべてのツールが利用可能になります。Mind Palaceダッシュボード（エージェントの脳のための視覚的UI）はhttp://localhost:3000で自動的に起動します。タブを開いたままにする必要はありません。ダッシュボードはバックグラウンドで実行され、MCPツールはそれがあってもなくても動作します。

🔮 プロのヒント: インストール後、ブラウザで http://localhost:3000 を開き、Mind Palaceダッシュボードを表示してください。エージェントの脳をリアルタイムで視覚化した美しいUIです。ナレッジグラフ、インテントヘルスゲージ、セッション台帳を探索できます。

🔄 Prismの更新: npx -yはパッケージをローカルにキャッシュします。最新バージョンへの更新を強制するには、MCPクライアントを再起動してください。npx -yが自動的に最新リリースを取得します。古いバージョンでスタックしている場合は、再起動前にnpx clear-npx-cache (またはnpm cache clean --force)を実行してください。

MCP設定のenvブロックにPRISM_DASHBOARD_PORTを追加します：

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"],
      "env": { "PRISM_DASHBOARD_PORT": "3001" }
    }
  }
}

その後、http://localhost:3001を開きます。

機能マトリックス

🔑 コアとなるMind Palaceは、APIキーなしで100%オフラインで動作します。クラウドキーはインテリジェンス機能をアンロックします。「環境変数」を参照してください。

💰 APIコストに関する注意: GOOGLE_API_KEY (Gemini) には、個人の使用のほとんどをカバーする寛大な無料枠があります。BRAVE_API_KEYは月間2,000回の無料検索を提供します。FIRECRAWL_API_KEYには500クレジットの無料プランがあります。一般的なソロ開発であれば、無料枠内で月額0ドルが期待できます。大量のチームや集中的な自律パイプラインの使用のみが、意味のあるコストを発生させます。

魔法の瞬間

セッション1 (月曜日の夜):

You: "Analyze this auth architecture and plan the OAuth migration."
Agent: *deep analysis, decisions, TODO list*
Agent: session_save_ledger → session_save_handoff ✅

セッション2 (火曜日の朝 — 新しい会話、新しいコンテキストウィンドウ):

Agent: session_load_context → "Welcome back! Yesterday we decided to use PKCE
       flow with refresh tokens. 3 TODOs remain: migrate the user table,
       update the middleware, and write integration tests."
You: "Pick up where we left off."

エージェントはすべてを記憶しています。 ファイルの再アップロードも、決定事項の再説明も不要です。

セットアップガイド

claude_desktop_config.jsonに追加します：

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

.cursor/mcp.json (プロジェクト) または ~/.cursor/mcp.json (グローバル) に追加します：

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

~/.codeium/windsurf/mcp_config.jsonに追加します：

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

Continueのconfig.jsonまたはCline MCP設定に追加します：

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"],
      "env": {
        "PRISM_STORAGE": "local",
        "BRAVE_API_KEY": "your-brave-api-key"
      }
    }
  }
}

Claude Codeは、ワークスペースの.clauderulesに追加することで、MCPツールを自然に取り込みます。単に追加するだけです：

Always start the conversation by calling `mcp__prism-mcp__session_load_context(project='my-project', level='deep')`.
When wrapping up, always call `mcp__prism-mcp__session_save_ledger` and `mcp__prism-mcp__session_save_handoff`.

フォーマットの注意: ClaudeはMCPツールを自動的に二重アンダースコア (mcp__prism-mcp__...) でラップしますが、他のほとんどのクライアントは単一アンダースコア (mcp_prism-mcp_...) を使用します。Prismのバックエンドは、両方のフォーマットをネイティブかつシームレスに処理します。

セッションの自動読み込みを確実にするための実証済みの3層プロンプトアーキテクチャについては、Geminiセットアップガイドを参照してください。

マシン間やチーム間でメモリを同期するには：

{
  "mcpServers": {
    "prism-mcp": {
      "command": "npx",
      "args": ["-y", "prism-mcp-server"],
      "env": {
        "PRISM_STORAGE": "supabase",
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_KEY": "your-supabase-anon-or-service-key"
      }
    }
  }
}

スキーマ移行

Prismは初回接続時にスキーマを自動適用するため、手動の手順は不要です。手動で移行を適用または再適用する必要がある場合（例：新しいプロジェクトやバージョンアップ後）、supabase/migrations/内のSQLファイルを番号順にSupabase SQLエディタまたはCLI経由で実行してください：

# Via CLI (requires supabase CLI + project linked)
supabase db push

# Or apply a single migration via the Supabase dashboard SQL Editor
# Paste the contents of supabase/migrations/0NN_*.sql and click Run

主要な移行:

• 020_* — コアスキーマ (台帳、ハンドオフ、FTS、TTL、CRDT)

• 033_memory_links.sql — 連想メモリグラフ (MemoryLinks) — session_backfill_linksに必要

Anonキー vs. サービスロールキー: Anonキーは個人使用に適しています（Supabase RLSポリシーが適用されます）。複数のユーザーが同じSupabaseプロジェクトを共有するチームデプロイメントでは、サービスロールキーを使用してください。RLSをバイパスし、認証コンテキストに関係なくPrismがすべての行を管理できるようにします。サービスロールキーをクライアントサイドで公開しないでください。

git clone https://github.com/dcostenco/prism-mcp.git
cd prism-mcp && npm install && npm run build

その後、MCP設定に追加します：

{
  "mcpServers": {
    "prism-mcp": {
      "command": "node",
      "args": ["/path/to/prism-mcp/dist/server.js"],
      "env": {
        "BRAVE_API_KEY": "your-key",
        "GOOGLE_API_KEY": "your-gemini-key"
      }
    }
  }
}

PrismはRenderのようなクラウドプラットフォームにネイティブにデプロイできるため、エージェントのメモリは常にオンラインであり、異なるマシンやチーム間でアクセス可能です。

1. このリポジトリをフォークします。

2. Renderダッシュボードで、リポジトリを指す新しいWeb Serviceを作成します。

3. セットアップウィザードで、ランタイムとしてDockerを選択します。

4. DockerfileパスをDockerfile.smitheryに設定します。

5. sseトランスポートを使用して、ローカルのMCPクライアントを新しいクラウドエンドポイントに接続します：

{
  "mcpServers": {
    "prism-mcp-cloud": {
      "command": "npx",
      "args": ["-y", "supergateway", "--url", "https://your-prism-app.onrender.com/sse"]
    }
  }
}

注意: Dockerfile.smitheryは、最適化されたマルチステージビルドを使用しており、開発環境でTypescriptを安全にコンパイルしてから、軽量化された本番イメージでサーバーを起動します。NPM公開は不要です！

一般的なインストール時の落とし穴

❌ npm install -gは使用しないでください: バイナリパス（例：/opt/homebrew/Cellar/node/23.x/bin/prism-mcp-server）をハードコーディングすると、特定のNode.jsバージョンに縛られます。Nodeが更新されると、パスは黙って壊れます。

**✅ 代