Memory Bank MCP

🚀 Memory Bank MCP

AI支援開発のためのガイド付きメモリバンクプラグイン

Memory Bank MCPは、Model Context Protocol (MCP) プラグインで、構造化されたMarkdownファイルを通じてAIアシスタントがプロジェクトのコンテキストを持続的に維持するのを支援します。直接的な操作ではなく、ガイド付きの指示を通じて、プロジェクトの目標、決定、進捗、パターンを追跡する体系的なアプローチを提供します。

✨ 主な機能

• ガイド付き操作：AIアシスタントが自ら操作を行うための指示を提供します。
• 構造化コンテキスト管理：5つの核心ファイルを通じてプロジェクト情報を整理します。
• インテリジェントガイダンス：初期化と更新のためのステップバイステップの指示を提供します。
• 柔軟な更新：異なる変更タイプに基づくスマートな更新ガイダンスを提供します。
• クロスプラットフォーム対応：Windows/macOS/Linux用の自動パス正規化を行います。

MCP設定

公開されているnpmパッケージを使用する場合：

{
  "mcpServers": {
    "memory-bank": {
      "command": "npx",
      "args": ["@neko0721/memory-bank-mcp"],
      "timeout": 600
    }
  }
}

🚀 クイックスタート

1. メモリバンクの初期化

   init-memory-bankを使用して、memory-bankディレクトリと核心ファイルを作成します。
   

2. メモリバンクの読み取り

   get-memory-bank-infoを使用して、メモリバンクのすべての内容を表示します。
   

3. メモリバンクの更新

   update-memory-bankを使用して、特定のファイルを更新するためのガイダンスを取得します。
   

💻 核心ファイル

1. productContext.md (プロダクトコンテキスト)

• プロジェクトの概要
• 目標と主要機能
• 全体アーキテクチャ
• 利用可能な場合は、projectBrief.mdを自動的に組み込みます。

2. activeContext.md (アクティブコンテキスト)

• 現在の作業状況
• 最近の変更
• 未解決の質問と問題
• 注目領域

3. progress.md (進捗)

• チェックリスト形式のタスク追跡
• 完了、現在、計画されたタスク
• 進捗タイムライン

4. decisionLog.md (決定ログ)

• アーキテクチャと実装の決定
• 根拠と影響
• 決定履歴

5. systemPatterns.md (システムパターン)

• 繰り返し出現するパターンと標準
• コーディング規約
• アーキテクチャパターン
• テスト戦略

📚 使い方ガイド

AIアシスタント向け

1. 各セッションの開始時：memory-bankディレクトリが存在するか確認し、存在する場合は get-memory-bank-info を使用してプロジェクトの状態を把握します。
2. 必要に応じて初期化：新しいプロジェクトの場合は、init-memory-bank を使用して初期化します。
3. コンテキストの読み取り：get-memory-bank-info を使用してプロジェクトの状態を把握します。
4. 更新ガイダンスの取得：update-memory-bank を使用して、特定のファイルを更新するためのガイダンスを取得します。
5. 指示に従う：提供されたガイダンスに従って、メモリバンクを維持します。

更新トリガー

• アーキテクチャ変更：主要な構造的な決定
• 機能完了：新しい機能または能力
• バグ修正：重要な問題の解決
• リファクタリング：コード構造の改善
• 決定：重要な技術的な選択
• 進捗更新：タスクの状態変更

🔧 ツールリファレンス

init-memory-bank

すべての核心ファイルでメモリバンクを初期化します。

パラメータ:

• rootPath：プロジェクトのルートディレクトリのパス
• force (オプション)：強制的に再初期化します。

戻り値: 作成されたファイルのリストと次のステップのガイダンス

get-memory-bank-info

メモリバンクのすべての内容を読み取り、返します (codelfのget-project-infoに似ています)。

パラメータ:

• rootPath：プロジェクトのルートディレクトリのパス

戻り値: AIコンテキスト用にフォーマットされたメモリバンクの内容

update-memory-bank

メモリバンクファイルを更新するためのガイダンスを提供します。

パラメータ:

• rootPath：プロジェクトのルートディレクトリのパス
• changeType：変更のタイプ (アーキテクチャ/機能/バグ修正/リファクタリング/決定/進捗)
• description：変更の簡単な説明

戻り値: テンプレートとタイムスタンプ付きの詳細な更新指示

📦 統合ヒント

Cursor設定

Settings → Rules → User Rulesに追加します：

任意のタスクを開始する前に、プロジェクト内にmemory-bankディレクトリが存在するか確認します。存在しない場合は、MCPコマンドのinit-memory-bankを実行します。
セッション開始時に、MCPコマンドのget-memory-bank-infoを使用してメモリバンクの内容を読み取ります。
タスクまたは会話を完了した後、MCPコマンドのupdate-memory-bankを使用してメモリバンクの内容を更新する必要があります。
MCPのガイダンスに従って、メモリバンクファイルを維持します。

Windsurf設定

Settings → Cascade → Memories and Rules → Global Rulesに追加します：

任意のタスクを開始する前に、プロジェクト内にmemory-bankディレクトリが存在するか確認します。存在しない場合は、MCPコマンドのinit-memory-bankを実行します。
セッション開始時に、MCPコマンドのget-memory-bank-infoを使用してメモリバンクの内容を読み取ります。
タスクまたは会話を完了した後、MCPコマンドのupdate-memory-bankを使用してメモリバンクの内容を更新する必要があります。
MCPのガイダンスに従って、メモリバンクファイルを維持します。

🤝 コントリビューション

コントリビューションを歓迎します！問題やプルリクエストを自由に提出してください。

📄 ライセンス

MIT

🙏 謝辞

SPARC手法とcodelfに触発されています。