メモリバンクMCPサーバー

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

概要

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

• MCPプロトコルを介してメモリバンクファイルへのリモートアクセスを提供します

• マルチプロジェクトのメモリバンク管理を可能にする

• 一貫したファイル構造と検証を維持

• プロジェクトメモリバンク間の適切な分離を確保

Related MCP server: mem0 MCP Server for Project Management

特徴

• 複数プロジェクトのサポート

  • プロジェクト固有のディレクトリ

  • ファイル構造の強制

  • パストラバーサル防止

  • プロジェクト一覧機能

  • プロジェクトごとのファイルリスト

• リモートアクセシビリティ

  • 完全な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で最初に文書化されたメモリ バンクの概念を実装し、リモート機能とマルチ プロジェクト サポートを追加して拡張します。