メモリバンク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 を自動的にインストールするには:

npx -y @smithery/cli install @alioshr/memory-bank-mcp --client claude

これにより、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 設定に次の構成を追加します。

{
  "allpepper-memory-bank": {
    "command": "npx",
    "args": ["-y", "@allpepper/memory-bank-mcp"],
    "env": {
      "MEMORY_BANK_ROOT": "<path-to-bank>"
    },
    "disabled": false,
    "autoApprove": [
      "memory_bank_read",
      "memory_bank_write",
      "memory_bank_update",
      "list_projects",
      "list_project_files"
    ]
  }
}

構成の詳細

• 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 サーバーを追加 -> 以下を追加します。

env MEMORY_BANK_ROOT=<path-to-bank> npx -y @allpepper/memory-bank-mcp@latest

カスタムIA指示

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

発達

基本的な開発コマンド:

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm run test

# Run tests in watch mode
npm run test:watch

# Run the server directly with ts-node for quick testing
npm run dev

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