MCP脳

Supabaseにデータを保存するMCPサーバーとして実装された認知記憶システム。エンティティとリレーションをサポートするナレッジグラフを、複数のClaudeインストール間で永続的に保存します。

知らせ

これはまだ開発途中の作業なので、調整なしでは完璧に動作するとは思わないでください。以前はMCP Memory Serverを使用していましたが、複数のコンピュータに同時にインストールされたClaudeでも動作させたかったのです。転送プロセスをハックしてみましたが、無駄な作業だったので、Supabaseに移行しました。一度起動すれば動作しますが、インストールがまだ十分に洗練されていません。まずClaude Desktopで動作させようとするのではなく、Cline Devなどのツールを使ってVSCでセットアップすることを強くお勧めします。私は2台の異なるラップトップとVPSでClaude DesktopとVSCをインストールし、すべて同じSupabase dbを共有しています。

特徴

• Supabaseを使用した永続ストレージ
• エンティティと関係を持つ知識グラフ構造
• 安全な同時アクセスのためのデータベースレベルのロック
• クロスプラットフォームサポート（macOS、Linux、Windows）
• 自動テーブル初期化
• デバッグログのサポート

前提条件

• Node.jsとnpm
• Claude拡張機能付きVSCode
• 次のいずれか:
  • 新しい Supabase アカウントとプロジェクト (プライマリインストール用)
  • 既存のインストールからの Supabase 資格情報 (セカンダリ インストール用)

インストールの種類

適切なインストールタイプを選択します。

1. 初期インストール：新しいSupabaseプロジェクトでmcp-brainをセットアップします。これは、mcp-brainを使用する最初のマシン用です。
2. セカンダリインストール：同じSupabaseデータベースを使用する追加のマシンにmcp-brainをインストールします。これにより、複数のマシンで同じナレッジグラフを共有できます。

インストール

インストールプロセスでは、プロジェクトのビルドとSupabaseの認証情報を使用した設定を行います。これは、提供されているスクリプトを使用して自動的に行うことも、手動で行うこともできます。

プライマリインストール

mcp-brain を初めてインストールする場合:

1. https://supabase.comで新しい Supabase プロジェクトを作成します。
2. プロジェクト設定 > API からプロジェクト URL と API キーを取得します。
3. 以下の自動または手動のインストール手順に従ってください
4. 二次インストールで使用するために Supabase の資格情報を保存します

二次インストール

追加のマシンに mcp-brain をインストールする場合:

1. プライマリインストールからSupabase URLとAPIキーを取得します
2. 以下の自動または手動のインストール手順に従ってください
3. 同じ認証情報を使用して、すべてのインスタンスが同じ知識グラフを共有するようにします。

オプションA: 自動インストール

1. プロジェクトをクローンしてビルドします。
   git clone https://github.com/gtrusler/mcp-brain.git cd mcp-brain npm install npm run build
2. 構成スクリプトを実行します。
   npm run configure
   SupabaseのURLとAPIキーを入力するよう求められます。スクリプトは自動的に以下の処理を実行します。
   • OS の MCP 設定ファイルを作成または更新します
   • ビルドされたファイルへの正しいパスを設定します
   • 既存のMCPサーバー構成を保持する

オプションB: 手動インストール

1. プロジェクトをクローンしてビルドします。
   git clone https://github.com/gtrusler/mcp-brain.git cd mcp-brain npm install npm run build
2. MCP 設定ファイルを見つけます。
   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
3. 設定ファイルで mcp-brain 構成を追加または更新します。
   { "mcpServers": { "mcp-brain": { "command": "node", "args": ["path/to/mcp-brain/dist/index.js"], "env": { "SUPABASE_URL": "your-project-url", "SUPABASE_KEY": "your-api-key", "DEBUG": "false" } } } }
   交換する：
   • path/to/mcp-brainリポジトリをクローンしてビルドした場所への絶対パスです
   • your-project-url Supabase プロジェクトの URL に置き換えます
   • your-api-key Supabase API キーに置き換えます

   注: 設定ファイルが既に存在する場合は、既存のMCPサーバー設定を必ず保持してください。mcpServersオブジェクト内のmcp-brainセクションのみを追加または更新してください。

Supabase の資格情報は、Supabase プロジェクト設定の「プロジェクト設定 > API」にあります。

変更の適用

インストール後または構成の変更後:

1. VSCode が開いている場合:
   • クロードの会話をすべて閉じる
   • 「開発者：ウィンドウの再読み込み」コマンドを実行します（Cmd/Ctrl + Shift + P を押して、「reload」と入力）
2. VSCode が閉じられている場合:
   • VSCodeを起動するだけで、新しい構成が自動的に読み込まれます。

インストールの確認

VSCode をリロードした後、次の操作を行ってセットアップを確認します。

1. クロードとの新しい会話の創造
2. Can you use your brain?のようなコマンドを実行して接続をテストする
3. 脳は自身の能力に関する情報で反応するはずだ

使用法

脳は、MCP プロトコルを通じて 3 つの主要なツールを提供します。

1. read_graph : ナレッジグラフ全体を読み取る
2. create_entities : 新しいメモリをエンティティとして保存する
3. create_relations : 記憶間のつながりを作成する

これらのツールは、Claude を通じて情報を永続的に保存および呼び出すために使用できます。

発達

• npm run build - TypeScriptプロジェクトをビルドする
• npm run configure - Supabase の資格情報を設定する
• npm start - MCP サーバーを直接起動します (通常は必要ありません)

建築

• TypeScriptと@modelcontextprotocol/sdkを使用します
• Supabase テーブルにデータを保存します。
  • エンティティ: ナレッジグラフ内のノード
  • 関係: エンティティを接続するエッジ
  • ロック: 同時アクセスのためのデータベースレベルのロック
• 初回実行時にテーブルを自動作成
• プラットフォームに依存しない構成

ライセンス

マサチューセッツ工科大学