MCPメモリゲートウェイ：Claude Codeにおける永続メモリのためのMCPサーバー

MCP Memory Gatewayは、Claude Codeにセッションを超えた永続的なメモリを与えるために特別に構築されたMCPサーバーです。このプロジェクトは、Claude Codeがセッション間で全てのコンテキストを失い、ユーザーが「PRレビュースレッドを確認せずにプッシュしないで」といった指示を何度も繰り返す必要がある問題に対処します。

仕組み

このシステムは、以下の4つの主要コンポーネントを通じて動作します：

• 収集: Claude Codeが何か間違ったことをしたとき（何が問題で、何を変更すべきか）や、正しいことをしたときに、ユーザーが構造化されたフィードバックを記録します。
• 昇格: 同じ失敗が3回以上発生すると、自動的に防止ルールになります。
• ゲート: 防止ルールはPreToolUseフックになります。Claude Codeがツール呼び出しを実行する前に、ゲートエンジンが既知の失敗パターンと一致するかチェックします。一致する場合、呼び出しはブロックされ、その理由と代わりに何をすべきかの説明が表示されます。
• 想起: セッション開始時に、過去のセッションからの関連コンテキストが注入され、Claude Codeが本来失うはずの履歴を保持できるようになります。

Claude Codeによる開発

開発者は数ヶ月にわたり、主要な開発ツールとしてClaude Codeを使用しました。Claude Codeはプロジェクトのほぼ全ての部分に関与しました：

• ツール呼び出しを保存された失敗ルールと比較するパターンマッチングシステムを含む、初期のゲートエンジンロジックを記述
• 構造化されたエントリが保存前に適切なスキーマを持つことを保証するフィードバック検証システムを生成
• ツール登録、リクエストルーティング、レスポンスフォーマットを処理するMCPプロトコル統合レイヤーを構築
• ネストされたツール呼び出しで防止ルールが発動しないバグを診断・修正し、再帰的なツールチェーンを処理するためにマッチングロジックを書き換え
• リファクタリング、テスト作成、セッション開始時にどのコンテキストを注入するかを選択する想起システムの反復改善に日常的に使用

始め方

コアは完全にオープンソースでMITライセンスであり、制限はありません。セットアップは1つのコマンドで実行できます：

npx mcp-memory-gateway init --agent claude-code

プロジェクトはGitHubで利用可能です：https://github.com/IgorGanapolsky/mcp-memory-gateway。