Charly Memory Cache

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

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

🚀 クイックスタート

📦 インストール

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

git clone git@github.com:ibproduct/ib-mcp-cache-server
cd ib-mcp-cache-server

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

npm install

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

npm run build

4. これをあなたのMCPクライアント設定に追加します：

{
  "mcpServers": {
    "memory-cache": {
      "command": "node",
      "args": ["/path/to/ib-mcp-cache-server/build/index.js"]
    }
  }
}

5. MCPクライアントを使用すると、サーバーは自動的に起動します。

🔍 正常動作の検証

サーバーが正常に動作しているとき、以下のような状況が見られます：

1. ターミナルに「メモリキャッシュMCPサーバーがstdio上で動作中」というメッセージが表示されます。
2. 同じデータに複数回アクセスすると、パフォーマンスが向上します。
3. 何も操作する必要はありません - キャッシュは自動的に行われます。

サーバーが動作しているかどうかを確認するには、以下の手順を行います：

1. MCPクライアントを開きます。
2. サーバーを起動したターミナルでエラーメッセージを探します。
3. キャッシュの恩恵を受ける操作（例：同じファイルを複数回読み取る）を実行します。

⚙️ 設定

config.jsonまたは環境変数を使用して設定を行います：

{
  "maxEntries": 1000,        // 最大保存項目数は1000
  "maxMemory": 104857600,    // 最大メモリ使用量（バイト単位、100MB）
  "defaultTTL": 3600,        // デフォルトの有効期限（秒単位、1時間）
  "checkInterval": 60000,    // クリーンアップの間隔（ミリ秒単位、1分）
  "statsInterval": 30000     // 統計情報の更新間隔（ミリ秒単位、30秒）
}

設定オプションの説明

1. maxEntries（デフォルト値：1000）

   • キャッシュに保存できる最大項目数です。
   • キャッシュの無制限な拡大を防ぎます。
   • 制限を超えると、最も古く使用されていない項目が最初に削除されます。

2. maxMemory（デフォルト値：100MB）

   • 最大メモリ使用量（バイト単位）です。
   • メモリの過剰消費を防ぎます。
   • 制限に達すると、最近最も使用されていない項目が削除されます。

3. defaultTTL（デフォルト値：3600）

   • デフォルトの有効期限（秒単位）です。
   • キャッシュ項目の有効期限を制御します。

4. checkInterval（デフォルト値：60000）

   • クリーンアップのチェック間隔（ミリ秒単位）です。
   • 期限切れのキャッシュを定期的にクリーンアップする間隔です。

5. statsInterval（デフォルト値：30000）

   • 統計情報の更新間隔（ミリ秒単位）です。
   • キャッシュの統計情報を更新する頻度です。

🧪 キャッシュの実際の効果をテストする

キャッシュの実際の動作を確認するには、以下のシナリオを試してみてください：

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

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

2. データ分析テスト

   • あるデータ分析を実行します。
   • 同じ分析結果を再度要求します。
   • 2回目の分析では、キャッシュされた結果が使用されます。

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

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

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

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