MI25-tuning-MCP

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

目的と責務

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

Related MCP server: ArmBench MCP Server

セットアップ

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

ツール一覧

環境変数

安全制約

• 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 で有効）

関連ドキュメント