Ibproduct Ib MCP Cache Server

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

このサーバーは、モデルコンテキストプロトコル（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. 自動キャッシュ：Cache-Control: no-cacheヘッダーが設定されていない限り、すべての応答が自動的にキャッシュされます。
2. 期限切れメカニズム：キャッシュエントリは設定された時間後に自動的に無効になります。
3. ヒット率統計：サーバーはキャッシュヒット回数を追跡し、コンソールに表示します。

自動キャッシュ管理

1. サーバー起動時に設定ファイルを読み込み、キャッシュを初期化します。
2. 定期的にキャッシュ領域の使用状況を確認し、制限を超えた場合は自動的にクリーンアップします。
3. 最大メモリ使用量を設定できるため、システムパフォーマンスに影響を与えることを避けることができます。

最適化のヒント

• エントリ数を調整する：プロジェクトの要件に応じてMAX_ENTRIESを増やすことで、ヒット率を向上させます。
• 有効期限を延長する：DEFAULT_TTLを適度に増やすことで、キャッシュの無効化回数を減らすことができます。
• 使用状況を監視する：定期的にヒット率とキャッシュサイズを確認し、最適なパフォーマンスを維持します。

環境変数設定

MCPクライアントで環境変数を設定することで、デフォルト値を上書きすることができます。

{
  "mcpServers": {
    "memory-cache": {
      "command": "node",
      "args": ["/path/to/build/index.js"],
      "env": {
        "MAX_ENTRIES": "5000",
        "MAX_MEMORY": "209715200",  // 200MB
        "DEFAULT_TTL": "7200",      // 2 hours
        "CHECK_INTERVAL": "120000",  // 2 minutes
        "STATS_INTERVAL": "60000"    // 1 minute
      }
    }
  }
}

また、カスタム設定ファイルのパスを指定することもできます。

{
  "env": {
    "CONFIG_PATH": "/path/to/your/config.json"
  }
}

サーバーは以下の手順で動作します。

1. ディレクトリ内でデフォルトの設定ファイルを検索します。
2. 環境変数の上書きを適用します。
3. 指定されていない場合は、デフォルト値を使用します。

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

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

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

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

2. データ分析テスト

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

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

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

キャッシュが正常に動作している場合、以下のことに気づくでしょう。

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