Memory Cache

🚀 メモリキャッシュサーバー

モデルコンテキストプロトコル（MCP）サーバーです。言語モデルの対話間でデータを効率的にキャッシュすることで、トークン消費を削減します。任意のMCPクライアントとトークンを使用する任意の言語モデルに対応しています。

🚀 クイックスタート

このメモリキャッシュサーバーは、言語モデルのトークン消費を削減するために、データをキャッシュする機能を提供します。以下に、サーバーのインストール、設定、使用方法を説明します。

📦 インストール

Smitheryを通じた自動インストール

Smithery を通じてClaude Desktopのメモリキャッシュサーバーを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @tosin2013/mcp-memory-cache-server --client claude

手動インストール

1. リポジトリをクローンします。

git clone https://github.com/tosin2013/mcp-memory-cache-server.git
cd mcp-memory-cache-server

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

📚 ドキュメント

設定方法

設定ファイルを使用する

config.json ファイルを作成し、以下の内容を記述します。

{
  "max_entries": 1000,
  "max_memory": 104857600, // 100MB
  "default_ttl": 3600,     // 1時間
  "check_interval": 60000,  // 1分
  "stats_interval": 120000  // 2分
}

環境変数で設定する

package.json のMCPクライアント部分で環境変数を設定することができます。

{
  "mcpServers": {
    "memory-cache": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "MAX_ENTRIES": "5000",
        "MAX_MEMORY": "209715200", // 200MB
        "DEFAULT_TTL": "7200",     // 2時間
        "CHECK_INTERVAL": "360000"  // 1時間
      }
    }
  }
}

サーバーは以下の順序で設定を読み込みます。

1. デフォルトの config.json ファイルを探します。
2. 環境変数による上書きを適用します。
3. 指定されていない場合は、デフォルト値を使用します。

主な機能

データの保存と取得

• 初めてデータに遭遇したときに自動的に保存します。
• キャッシュが利用可能な場合は、データを提供します。

自動削除策略

• 設定に基づいて古いまたは使用頻度の低いエントリを削除します。
• メモリ使用量を監視し、制限を超えないようにします。

性能最適化のヒント

適切なTTL（有効期限）を設定する

• 頻繁に変化するデータには、短いTTLを使用します。
• 静的なコンテンツには、長いTTLを使用します。

メモリ制限を調整する

• メモリ制限を高く設定すると、より多くのキャッシュが可能になり、トークンの節約につながります。
• メモリ使用量が問題になる場合は、メモリ制限を下げてください。

キャッシュ統計を監視する

• 高いヒット率は、良好なトークン節約効果を示します。
• ヒット率が低い場合は、TTLまたは制限を調整してください。

実践的なキャッシュテスト

キャッシュの効果を確認するには、以下のシナリオを試してみてください。

1. ファイル読み取りテスト

   • 大きなファイルを読み取り、分析します。
   • 同じファイルに関する質問を再度行います。
   • 2回目の応答は、ファイル内容がキャッシュされているため、より速くなります。

2. データ分析テスト

   • いくつかのデータ分析タスクを実行します。
   • 同じ分析結果を再度要求します。
   • 2回目の分析は、キャッシュされた結果を使用するため、より速くなります。

3. プロジェクトナビゲーションテスト

   • プロジェクトの構造を探索します。
   • 同じファイル/ディレクトリを再度照会します。
   • ディレクトリリストとファイル内容は、キャッシュから提供されます。

キャッシュが機能していることを示す兆候は以下の通りです。

• 繰り返しの操作の応答速度が向上する。
• 変更されていないコンテンツに対する回答が一致する。
• 変更されていないファイルを再読み取りする必要がない。