Memory Bank MCP Server

メモリバンクMCPサーバー

Cline Memory Bankにヒントを得た、リモート メモリ バンク管理用の Model Context Protocol (MCP) サーバー実装。

概要

メモリ バンク MCP サーバーは、従来のファイルベースのメモリ バンクを、次のような機能を備えた集中型サービスに変換します。

• MCPプロトコルを介してメモリバンクファイルへのリモートアクセスを提供します
• マルチプロジェクトのメモリバンク管理を可能にする
• 一貫したファイル構造と検証を維持
• プロジェクトメモリバンク間の適切な分離を確保

特徴

• 複数プロジェクトのサポート
  • プロジェクト固有のディレクトリ
  • ファイル構造の強制
  • パストラバーサル防止
  • プロジェクト一覧機能
  • プロジェクトごとのファイルリスト
• リモートアクセシビリティ
  • 完全なMCPプロトコル実装
  • 型安全な操作
  • 適切なエラー処理
  • プロジェクトの分離によるセキュリティ
• コアオペレーション
  • メモリバンクファイルの読み取り/書き込み/更新
  • 利用可能なプロジェクトの一覧
  • プロジェクト内のファイルを一覧表示する
  • プロジェクトの存在検証
  • 安全な読み取り専用操作

インストール

Smithery経由で Claude Desktop 用の Memory Bank Server を自動的にインストールするには:

これにより、MCPサーバーの設定が自動的に行われます。または、以下の「設定」セクションの説明に従って、手動でサーバーを設定することもできます。

クイックスタート

1. 設定でMCPサーバーを構成します（以下の構成セクションを参照）
2. AIアシスタントのメモリバンクツールを使い始めましょう

構成

メモリバンクMCPサーバーは、Cline MCP設定ファイルで設定する必要があります。場所は設定によって異なります。

• Cline 拡張機能の場合: ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Roo Code VS Code 拡張機能の場合: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
• Claude デスクトップ アプリの場合: ~/Library/Application Support/Claude/claude_desktop_config.json

MCP 設定に次の構成を追加します。

構成の詳細

• MEMORY_BANK_ROOT : プロジェクトのメモリバンクが保存されるディレクトリ（例： /path/to/memory-bank ）
• disabled : サーバーを有効にするにはfalseに設定します
• autoApprove : 明示的なユーザー承認を必要としない操作のリスト:
  • memory_bank_read : メモリバンクファイルを読み取る
  • memory_bank_write : 新しいメモリバンクファイルを作成する
  • memory_bank_update : 既存のメモリバンクファイルを更新する
  • list_projects : 利用可能なプロジェクトを一覧表示する
  • list_project_files : プロジェクト内のファイルを一覧表示する

カーソル用

カーソルの場合は、設定を開き、機能 -> MCP サーバーを追加 -> 以下を追加します。

カスタムIA指示

このセクションには、Cline、Claude、Cursor、またはその他のMCPクライアントのAIカスタムインストラクションに貼り付ける指示が含まれています。これらのルールをコピー＆ペーストしてください。これらのルールはcustom-instructions.mdに記載されていますので、ご参照ください。

発達

基本的な開発コマンド:

Dockerで実行する

1. Docker イメージをビルドします。
   docker build -t memory-bank-mcp:local .
2. テスト用に Docker コンテナを実行します。
   docker run -i --rm \ -e MEMORY_BANK_ROOT="/mnt/memory_bank" \ -v /path/to/memory-bank:/mnt/memory_bank \ --entrypoint /bin/sh \ memory-bank-mcp:local \ -c "ls -la /mnt/memory_bank"
3. MCP 構成を追加します (Roo Code の例)。
   "allpepper-memory-bank": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "MEMORY_BANK_ROOT", "-v", "/path/to/memory-bank:/mnt/memory_bank", "memory-bank-mcp:local" ], "env": { "MEMORY_BANK_ROOT": "/mnt/memory_bank" }, "disabled": false, "alwaysAllow": [ "list_projects", "list_project_files", "memory_bank_read", "memory_bank_update", "memory_bank_write" ] }

貢献

貢献を歓迎します！以下の手順に従ってください。

1. リポジトリをフォークする
2. 機能ブランチを作成する ( git checkout -b feature/amazing-feature )
3. 変更をコミットします（ git commit -m 'Add amazing feature' ）
4. ブランチにプッシュする ( git push origin feature/amazing-feature )
5. プルリクエストを開く

開発ガイドライン

• すべての新しいコードにTypeScriptを使用する
• コードベース全体で型の安全性を維持する
• 新機能のテストを追加する
• 必要に応じてドキュメントを更新する
• 既存のコードスタイルとパターンに従う

テスト

• 新しい機能のユニットテストを書く
• 複数プロジェクトのシナリオテストを含める
• エラーケースを徹底的にテストする
• 型制約を検証する
• ファイルシステム操作を適切にモックする

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

謝辞

このプロジェクトは、Cline Memory Bankで最初に文書化されたメモリ バンクの概念を実装し、リモート機能とマルチ プロジェクト サポートを追加して拡張します。