プロジェクト

全般

プロフィール

バグ #940

未完了

Claude Desktop v3.0対応 統合最適化システム実装

Redmine Admin さんが約1ヶ月前に追加. 約1ヶ月前に更新.

ステータス:
進行中
優先度:
急いで
担当者:
-
開始日:
2025-07-19
期日:
進捗率:

0%

予定工数:

説明

Claude Desktop v3.0対応 統合最適化システム実装

🎯 プロジェクト概要

目的

Claude Desktop MCPツールのトークン消費量を85-95%削減し、v3.0ユーザープリファレンス完全対応システムを構築する。

問題現状

  • 毎回の作業で5000-8000トークン消費
  • 複数MCPサーバの個別呼び出しによる非効率
  • 会話開始時のコンテキスト復旧手作業
  • desktop-commander-wsl非使用によるVPS操作代替手段必要

目標効果

  • 会話開始時確認: 5000→500トークン(90%削減)
  • 継続作業判定: 3000→300トークン(90%削減)
  • 作業中操作: 8000→1000トークン(87%削減)

📋 実装スコープ

Phase 1: 基盤システム構築(即座実装)

  1. Claude v3.0対応コンテキストマネージャー

    • 配置先: /root/claude-v3-optimizer/claude-context-manager.sh
    • 機能: 自動コンテキスト復旧、軽量情報取得、セッション管理
    • v3.0必須機能: Always適用の会話開始時復旧
  2. VPS-ROOT統合MCPサーバー

    • 配置先: /root/vps-root-unified-mcp/server.py
    • 統合対象: redmine-mcp + filesystem + git-local + システム管理
    • desktop-commander除外版: 直接SSH/tmux経由操作

Phase 2: 統合運用開始(今週内)

  1. Claude Desktop設定統合

    • 既存MCPサーバ保護
    • 統合MCPサーバ追加
    • 並行運用テスト
  2. トークン削減効果測定

    • Before/After比較
    • 使用頻度別最適化効果確認

Phase 3: 拡張機能実装(来週~)

  1. FastMCPプロキシ導入

    • Webアクセス対応
    • リモートMCP化準備
  2. 完全最適化システム

    • 事前計算キャッシュ
    • バッチ操作機能

🛠️ 技術仕様

現在利用MCPサーバ(desktop-commander除外)

  • ✅ redmine-mcp: Redmineチケット管理(最重要)
  • ✅ filesystem: ローカルファイルシステム
  • ✅ playwright: ブラウザ自動化
  • ✅ Canva: デザイン統合
  • 🔄 git-local: Git操作管理(追加予定)

統合MCPサーバ主要機能

  • auto_context_recovery(): v3.0必須の自動コンテキスト復旧
  • redmine_batch_operations(): Redmine統合操作
  • filesystem_batch_operations(): ファイル一括処理
  • vps_system_check(): システム監視(desktop-commander代替)
  • git_repo_status(): Git複数リポジトリ管理
  • save_session_context(): セッション状況保存

VPS環境

  • VPS-ROOT: Ubuntu 24.04.2 LTS @ 85.131.243.51
  • SSH接続: ~/.ssh/003-key.pem経由
  • 既存インフラ: 33コンテナ、12ドメイン運用中
  • 運用ツール: /root/vps-quick-scripts.sh活用

📊 期待効果・成功指標

トークン削減効果

操作種別 現在 最適化後 削減率
会話開始時確認 5000-8000 200-500 90-95%
継続作業判定 3000-5000 100-300 85-90%
作業中断・復旧 4000-7000 300-800 75-85%
詳細診断 8000-12000 2000-4000 50-70%

機能改善効果

  • 会話間コンテキスト継承: 手動→完全自動
  • 複数MCPサーバ呼び出し: 個別→統合バッチ処理
  • VPS操作: desktop-commander依存→直接SSH/tmux
  • 作業効率: 段階的情報取得による最適化

🚀 実装手順

Step 1: 基盤ファイル配置

# 1. コンテキストマネージャー配置
mkdir -p /root/claude-v3-optimizer
# claude-context-manager.sh を配置・実行権限付与

# 2. 統合MCPサーバー配置  
mkdir -p /root/vps-root-unified-mcp
# server.py を配置・依存関係インストール

# 3. ディレクトリ準備
mkdir -p /root/.claude-context/cache

Step 2: 動作確認テスト

# 1. コンテキストマネージャーテスト
/root/claude-v3-optimizer/claude-context-manager.sh auto-recovery

# 2. 統合MCPサーバーテスト  
cd /root/vps-root-unified-mcp && python server.py

# 3. 機能別テスト
/root/claude-v3-optimizer/claude-context-manager.sh context

Step 3: Claude Desktop統合

// claude_desktop_config.json 追加設定
{
  "mcpServers": {
    "vps-root-unified": {
      "command": "python",
      "args": ["/root/vps-root-unified-mcp/server.py"],
      "env": {
        "PYTHONPATH": "/root/vps-root-unified-mcp"
      }
    }
  }
}

⚠️ 注意事項・制約

既存環境保護

  • desktop-commander-wsl: 使用しない(ユーザー要求)
  • 既存MCPサーバ: 並行運用で影響回避
  • claude_desktop_config.json: 追加のみ、変更なし

技術的制約

  • SSH接続必須: ~/.ssh/003-key.pem の正常動作確認
  • Python環境: MCP SDK、httpx、fastapi等のインストール
  • tmux環境: セッション管理用tmux利用可能性確認

セキュリティ考慮

  • Redmine APIキー: 環境変数化推奨
  • SSH鍵: 適切な権限設定確認
  • VPS直接操作: 安全なコマンド実行のみ

📋 完了条件

Phase 1完了条件

  • claude-context-manager.sh 正常動作
  • vps-root-unified-mcp 基本機能動作
  • auto_context_recovery 機能確認
  • トークン削減効果の初期測定

Phase 2完了条件

  • Claude Desktop統合完了
  • 既存MCPサーバとの並行運用確認
  • 日常作業でのトークン削減効果実測

Phase 3完了条件

  • FastMCPプロキシ導入
  • 完全最適化システム運用開始
  • 85-95%トークン削減目標達成

📞 サポート・エスカレーション

技術的問題

  • SSH接続問題: ネットワーク・鍵権限確認
  • Python依存関係: 仮想環境構築検討
  • MCP統合問題: ログ確認・段階的デバッグ

運用問題

  • 既存ワークフロー影響: 並行運用による段階的移行
  • パフォーマンス問題: キャッシュ・バッチ処理調整
  • ユーザビリティ: フィードバックベース改善

優先度: 高
期限: Phase 1 - 即座実装、Phase 2 - 今週内、Phase 3 - 来週~
担当: Claude自律実行 + ユーザー確認
関連チケット: #602 (リモートMCP対応基盤)

他の形式にエクスポート: Atom PDF