Context Optimizer MCP

🚀 コンテキストオプティマイザ MCP

Redisとメモリキャッシュを使用して、大規模なチャット履歴のコンテキストウィンドウを最適化および拡張するMCP（モデルコンテキストプロトコル）サーバーです。

✨ 主な機能

• 二重キャッシュ：高速なメモリLRUキャッシュと永続化されたRedisストレージを組み合わせます。
• インテリジェントなコンテキスト管理：token制限内でコンテキストを維持するために、古いメッセージを自動的に要約します。
• レート制限：Redisベースのレート制限で、突発的なアクセスを保護します。
• API互換性：即座に使用できるAnthropic APIの代替案で、強化されたコンテキスト処理能力を備えています。
• 指標収集：組み込みのパフォーマンス監視とログ記録機能があります。

📚 ドキュメント

このMCPサーバーは、アプリケーションとLLMプロバイダー（現在はAnthropicのClaudeモデルをサポート）の間のミドルウェアとして機能します。以下の戦略でコンテキストをスマートに管理します。

• メッセージの長さがtoken制限を超えると、システムは自動的に古いメッセージを要約します。
• メッセージの数がしきい値を超えると、システムは最近のN個のメッセージを保持し、古いメッセージを破棄します。

🚀 クイックスタート

前提条件

• オペレーティングシステム：LinuxまたはmacOS（Windowsでは追加の設定が必要になる場合があります）
• メモリ要件：少なくとも4GB RAM（推奨は8GB以上）
• ディスクスペース：少なくとも10GBの空き容量
• 依存関係のインストール：
  • Python 3.8以上
  • Redis 6.x
  • pip

📦 インストール

npxを使用したインストール

npx mcp install degenhero/context-optimizer-mcp

手動インストール

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

   git clone https://github.com/yourusername/context-optimizer-mcp.git
   cd context-optimizer-mcp
   

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

   pip install -r requirements.txt
   

3. サービスを起動します：

   python app.py
   

Dockerを使用したインストール

1. イメージを取得します：

   docker pull yourusername/context-optimizer-mcp:latest
   

2. コンテナを実行します：

   docker run -d --name context-optimizer-mcp -p 5000:5000 yourusername/context-optimizer-mcp:latest
   

🔧 設定

config.yml ファイルを作成または編集し、以下の内容を記述します。

# システム設定
system:
  port: 5000
  debug_mode: false
  log_level: INFO

# キャッシュ設定
cache:
  type: redis
  host: localhost
  port: 6379
  db: 0

# コンテキスト制限
context_limit:
  max_tokens: 1200
  max_messages: 20

💻 使用例

基本的な使用法

リクエスト形式

すべてのリクエストはHTTPで送信され、以下の要件を満たす必要があります。

• サポートされるMIMEタイプ：application/json
• リクエストボディ形式：

{
    "messages": [
      { "role": "system", "content": "あなたは誠実で友好的なアシスタントです。" },
      { "role": "user", "content": "これはユーザーのクエリです。" }
    ],
    "model": "gpt-3.5-turbo",
    "temperature": 0.7,
    "conversation_id": "1234567890"
}

高度な使用法

特殊パラメータ

リクエストに以下のオプションパラメータを追加します。

{
    "messages": [ ... ],
    "model": "...",
    "temperature": ...,
    "conversation_id": "...",
    "context_optimization": true
}

テスト

テストスクリプトを実行します。

python test.py

または手動で実行します。

# サービスを起動した後、ブラウザで http://localhost:5000/test にアクセスします。

🔧 高度な機能

コンテキスト要約

リクエストのtoken数が max_tokens 制限を超えると、システムは自動的に古いメッセージを要約します。

会話の継続性

conversation_id が同じ場合、サーバーは会話履歴を保持し、現在のコンテキストに統合します。

パフォーマンスに関する考慮事項

• メモリキャッシュは最速のアクセス速度を提供します。
• Redisは永続化と複数インスタンス間の共有を実現します。
• 要約操作は、しきい値を超えるリクエストに一定の遅延を引き起こします。

📚 ドキュメント

詳細なドキュメントは docs/ ディレクトリを参照してください。

• アーキテクチャの概要
• コントリビューションガイド

📄 ライセンス

MIT