Bencher MCP の使い方


Bencher MCP はホスト型の Model Context Protocol(MCP)サーバーです。 bencher CLI をインストールしなくても、AI エージェントやアシスタントがベンチマークデータを照会し、ベンチマーク結果を送信できます。

bencher CLI が利用できる場合は、引き続き CLI が Bencher を使う推奨の方法です。 bencher run はベンチマークハーネスのアダプター、イテレーション、CI 連携を処理します。 CLI がインストールされていない場合や、MCP クライアントがシェルコマンドを実行できない場合に Bencher MCP を使用してください。

接続

デプロイメントURL
Bencher Cloudhttps://mcp.bencher.dev/mcp
Bencher Self-Hostedhttps://<api-host>/mcp

たとえば、Claude Code から接続するには:

Terminal window
claude mcp add --transport http bencher https://mcp.bencher.dev/mcp \
--header "Authorization: Bearer $BENCHER_API_KEY"

または、汎用的な MCP クライアント設定を使用します:

{
"mcpServers": {
"bencher": {
"type": "http",
"url": "https://mcp.bencher.dev/mcp",
"headers": {
"Authorization": "Bearer ${BENCHER_API_KEY}"
}
}
}
}

認証

Bencher MCP は Bencher API と同じ Authorization: Bearer 認証情報を受け付けます: プロジェクト API キー(bencher_run_*)またはユーザー API キー(bencher_user_*)です。 パブリックプロジェクトは認証情報なしで読み取れます。 OAuth はまだサポートされていないため、リモートサーバーに対して OAuth のみをサポートする MCP クライアントは現時点では接続できません。

プロジェクト API キーは単一のプロジェクトにスコープされるため、ほとんどのエージェントに最適な選択です。 ユーザー API キーはユーザーのすべてのプロジェクトにアクセスできます。

ツール

ツールの範囲は、プロジェクト API キー(bencher_run_*)で実行できる操作を反映しています: プロジェクトスコープの読み取りと、非破壊的な書き込みです。 削除やリネームのツールは存在せず、プロジェクト API キーではアラートの更新はステータスのみに制限されます。 ほとんどのツールは project 引数を取り、プロジェクトのスラッグまたは UUID を受け付けます。

ツール用途
submit_runベンチマークハーネスの生の出力を送信します。サーバーが解析し、ブランチ、テストベッド、しきい値を必要に応じて自動作成します
query_perf, perf_imageベンチマークメトリクスの推移を照会し、パフォーマンスプロット画像を生成します
list_projects, view_projectプロジェクト
list_reports, create_report, view_reportレポート
list_branches, create_branch, view_branch, update_branchブランチ
list_testbeds, create_testbed, view_testbed, update_testbedテストベッド
list_benchmarks, create_benchmark, view_benchmark, update_benchmarkベンチマーク
list_measures, create_measure, view_measure, update_measureメジャー
list_thresholds, create_threshold, view_threshold, update_thresholdしきい値
list_alerts, view_alert, update_alertアラート
view_metric単一のメトリクスとその完全なコンテキスト
list_plots, view_plot保存済みダッシュボードプロット
list_jobs, view_jobベアメタルランナージョブ
🤖 このドキュメントは AI によって自動的に翻訳されました。 正確ではない可能性があり、間違いが含まれている可能性があります。 エラーを見つけた場合は、GitHub で問題を開いてください。.


Published: Sat, July 18, 2026 at 7:00:00 AM UTC