MI25-tuning-MCP

MI25-tuning-MCP

MI25 / gfx900 向け multi_llm-client 運用のための MCP サーバーです。

---

目的と責務

MI25-tuning-MCP は クライアント・実験ワークフロー層 を担います。

| 担当する | 担当しない | |----------|-----------| | multi_llm-client の設定変更（安全な部分更新） | GPU / ROCm / Ollama のインフラ観測 | | 推論実行・ログ読取・要約 | → ROCm-ollama-mcp が担当 | | ノート記録 | |

---

セットアップ

cd /home/limonene/ROCm-project/MI25-tuning-MCP
python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -e .

起動:

mi25-tuning-mcp

---

ツール一覧

| ツール | 概要 | |--------|------| | ping | ヘルスチェック・パス確認 | | get_gpu_metrics | rocm-smi 経由で MI25 の VRAM / 温度 / 使用率を取得（未導入でも非エラー返却） | | list_presets | gfx900 プリセット名とデフォルトパラメータ一覧 | | get_config | config.json の読み取り | | update_config | allowlist キーを部分マージで更新（.bak 自動作成） | | run_inference | Rust クライアントでワンショット推論を実行 | | run_client_bench | Rust クライアントの --bench を実行し、phase_summary 生成まで返却 | | run_client_bench_compare | 2つの phase_summary.tsv を比較して差分 TSV を生成（成功/失敗ログを multi_llm-client/worklog に自動追記） | | run_client_bench_report | 既存 bench TSV から mode summary レポートを生成（tsv/markdown/json/all） | | read_perf_log | JSONL ログの末尾 N 件を取得 | | read_inference_logs | read_perf_log の別名（広域履歴参照用） | | summarize_perf_log | TTFT / tok/s / エラー率などを集計 | | list_dir | ディレクトリ一覧（プロジェクトルート配下） | | read_text / read_file | テキストファイル読み取り（プロジェクトルート配下） | | write_file | ノートへの書き込み（Agents-note/ 配下限定） | | run_client_check | cargo check を実行してビルドエラーを確認 | | set_config_raw | 設定の全体上書き（MI25_ENABLE_SET_CONFIG_RAW=1 で有効化、既定は無効） |

---

環境変数

| 変数 | 既定値 | 説明 | |------|--------|------| | MI25_CLIENT_ROOT | ../multi_llm-client | Rust クライアントのディレクトリ | | MI25_NOTES_ROOT | ../Agents-note | write_file の書き込み先ルート | | MI25_MCP_AUDIT_LOG | ./logs/tool-calls.jsonl | 監査ログの出力先 | | MI25_ENABLE_SET_CONFIG_RAW | 0 | set_config_raw の有効化フラグ |

---

安全制約

• update_config: allowlist 外のキーは拒否。更新前に .bak を保存
• write_file: Agents-note/ 配下のみ書き込み可
• read_file / read_text / list_dir: プロジェクトルート配下のみ参照可
• run_inference: タイムアウト必須、実行後に config.json を必ず復元
• run_client_bench: mode allowlist を強制し、--bench 固定テンプレートのみ実行
• run_client_bench_compare: 入出力 TSV パスを CLIENT_ROOT / PROJECT_ROOT 配下に限定
• run_client_bench_report: 入出力 TSV/レポートパスを CLIENT_ROOT / PROJECT_ROOT 配下に限定
• set_config_raw: 既定無効。明示的な環境変数が必要
• subprocess: 固定コマンドテンプレートのみ使用（free-form shell 禁止）
• 全ツール: 監査ログ JSONL に tool call を記録

---

Claude Code への接続

~/.claude/settings.json の mcpServers に追加します:

{
  "mcpServers": {
    "mi25_tuning": {
      "command": "/home/limonene/ROCm-project/MI25-tuning-MCP/.venv/bin/mi25-tuning-mcp",
      "args": [],
      "cwd": "/home/limonene/ROCm-project/MI25-tuning-MCP",
      "env": {
        "MI25_CLIENT_ROOT": "/home/limonene/ROCm-project/multi_llm-client",
        "MI25_NOTES_ROOT": "/home/limonene/ROCm-project/Agents-note"
      }
    }
  }
}

または mcp-config.json を ollama-mcp-bridge 経由で使用することもできます。

---

Antigravity MCP 設定

Antigravity で使う場合は ~/.gemini/antigravity/mcp_config.json に mcpServers を定義します。 テンプレートをコピーして実パスを展開します:

export ROCM_PROJECT_ROOT="/home/limonene/ROCm-project"
cp "${ROCM_PROJECT_ROOT}/MI25-tuning-MCP/mcp_config.template.json" \
  "${HOME}/.gemini/antigravity/mcp_config.json"
sed -i "s#<ROCM_PROJECT_ROOT>#${ROCM_PROJECT_ROOT}#g" \
  "${HOME}/.gemini/antigravity/mcp_config.json"

• command は絶対パスを使用してください
• 反映後は Antigravity の Language Server を再起動（または Window Reload）
• Claude Code と併用する場合はプロジェクトルートの .mcp.json と内容を揃えると管理が楽です

---

動作確認

インストール後、以下の順で疎通を確認します:

ping → get_config → update_config → run_inference → read_perf_log → summarize_perf_log

bench 系の標準フロー:

run_client_bench (baseline) -> run_client_bench (side) -> run_client_bench_compare -> run_client_bench_report

成果物の既定保存先（MI25_CLIENT_ROOT=<project>/multi_llm-client の場合）:

• baseline/side TSV: <project>/multi_llm-client/worklog/mcp_bench_*
• compare TSV: <project>/multi_llm-client/worklog/mcp_bench_compare_*
• report TSV/MD/JSON: <project>/multi_llm-client/worklog/*_mode_summary.(tsv|md|json)
• compare 成功追記: <project>/multi_llm-client/worklog/mcp_bench_compare_auto_summary_YYYY-MM-DD.md
• compare 失敗追記: <project>/multi_llm-client/worklog/mcp_bench_compare_fail_YYYY-MM-DD.jsonl

---

テスト実行

cd /home/limonene/ROCm-project/MI25-tuning-MCP
source .venv/bin/activate
./tests/smoke.sh

# LLM 統合テストも実行する場合
MI25_RUN_LLM_INTEGRATION=1 ./tests/smoke.sh

# bench -> phase_summary -> compare の MCP 統合テストも実行する場合
MI25_RUN_BENCH_INTEGRATION=1 ./tests/smoke.sh

smoke.sh が実行するテスト:

1. コンパイルチェック + ツール形状チェック
2. tests/unit_direct_test.py — MCP 単体 / 失敗系 / サンドボックス統合
3. tests/protocol_tools_test.py — stdio MCP プロトコル（tools/list / tools/call）
4. tests/llm_bridge_integration_test.py — ブリッジ経由 LLM 統合（MI25_RUN_LLM_INTEGRATION=1 で有効）
5. tests/bench_flow_integration_test.py — MCP 経由 bench -> phase_summary -> compare（MI25_RUN_BENCH_INTEGRATION=1 で有効）

---

関連ドキュメント

| ドキュメント | 内容 | |------------|------| | SPEC.md | 仕様書（設計決定・安全制約・DoD） | | MI25-tuning-MCP_TODO.md | 実装状況・残課題（MI25_TODO集約） | | docs/tool-spec.md | ツール仕様詳細 | | vega_optimize.md | Vega/gfx900 最適化の定性戦略メモ | | vega_optimize-statistics.md | Vega/gfx900 最適化の定量メモ（実測値） | | agreement.md | 正本合意書 | | ROCm-ollama-mcp | インフラ層 MCP（GPU / ROCm / Ollama 観測） |