metrxbots

Metrx MCP Server

AI エージェントはお金を無駄にしています。 Metrx はその金額を明らかにし、無駄を解消します。

Metrx の公式 MCP サーバーです。Metrx は AI エージェントのコストインテリジェンスプラットフォームです。MCP 互換エージェント（Claude、GPT、Gemini、Cursor、Windsurf）に、自身のコストを追跡し、無駄を検出し、モデル選択を最適化して、ROI を証明する機能を提供します。

Metrx を選ぶ理由

問題	Metrx ができること
エージェントの利用料金が見えない	エージェント、モデル、プロバイダーごとのリアルタイムコストダッシュボード
LLM 呼び出しに過剰な料金を支払っている	プロバイダー間の価格比較により、同じタスクに使えるより安価なモデルを見つけます
コストが際限なく増加する	上限に達した際に自動一時停止する予算管理
トークンを浪費している	コスト漏れスキャナーが、リトライの集中、コンテキストの肥大化、モデルの不一致を検出します
AI の ROI を証明できない	収益の帰属分析により、エージェントのアクションをビジネス成果に結び付けます

クイックスタート

今すぐ試す — サインアップ不要

npx @metrxbot/mcp-server --demo

サンプルデータを使ってサーバーを起動し、23 個すべてのツールをすぐに試せます。

実データを接続する

オプション A — 対話型ログイン（推奨）：

npx @metrxbot/mcp-server --auth

ブラウザーを開いて API キーを取得し、検証したうえで ~/.metrxrc に保存します。環境変数を設定する必要はありません。

オプション B — 環境変数：

METRX_API_KEY=sk_live_your_key_here npx @metrxbot/mcp-server --test

無料の API キーは app.metrxbot.com/sign-up で取得できます。

MCP クライアント（Claude Desktop、Cursor、Windsurf）に追加する

--auth を使用した場合、~/.metrxrc からキーが自動的に読み込まれるため、env ブロックは不要です。

{
  "mcpServers": {
    "metrx": {
      "command": "npx",
      "args": ["@metrxbot/mcp-server"]
    }
  }
}

または、環境変数を使ってキーを明示的に渡します。

{
  "mcpServers": {
    "metrx": {
      "command": "npx",
      "args": ["@metrxbot/mcp-server"],
      "env": {
        "METRX_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

リモート HTTP エンドポイント

リモートエージェント向け（ローカルへのインストールは不要です）：

POST https://metrxbot.com/api/mcp
Authorization: Bearer sk_live_your_key_here
Content-Type: application/json

npm から

npm install @metrxbot/mcp-server

10 の分野にわたる 23 個のツール

ダッシュボード（3 個のツール）

ツール	説明
metrx_get_cost_summary	コストの包括的な概要 — 総利用額、呼び出し回数、エラー率、最適化の機会
metrx_list_agents	ステータス、カテゴリ、コスト指標、健全性の指標を含む、すべてのエージェントの一覧
metrx_get_agent_detail	モデル、フレームワーク、コストの内訳、パフォーマンス履歴を含む詳細なエージェント情報

最適化（4 個のツール）

ツール	説明
metrx_get_optimization_recommendations	エージェント別または全エージェントを対象とした、AI によるコスト最適化の推奨事項
metrx_apply_optimization	最適化の推奨事項をワンクリックでエージェントに適用
metrx_route_model	複雑さに基づく、特定のタスクに適したモデルのルーティング提案
metrx_compare_models	プロバイダー間で LLM モデルの価格と機能を比較

予算（3 個のツール）

ツール	説明
metrx_get_budget_status	利用額と上限を含む、すべての予算設定の現在のステータス
metrx_set_budget	ハード、ソフト、または監視の適用モードを設定した予算の作成または更新
metrx_update_budget_mode	既存の予算の適用モードを変更するか、一時停止または再開

アラート（3 ツール）

ツール	説明
metrx_get_alerts	エージェントフリートのアクティブなアラートと通知
metrx_acknowledge_alert	1 つ以上のアラートを既読／確認済みとしてマーク
metrx_get_failure_predictions	障害予測分析 — 発生前に障害が起きそうなエージェントを特定

実験（3 ツール）

ツール	説明
metrx_create_model_experiment	トラフィックを分割し、2 つの LLM モデルを比較する A/B テストを開始
metrx_get_experiment_results	統計的有意性、コスト差、おすすめのアクション
metrx_stop_experiment	実行中のモデルルーティング実験を停止し、勝者を確定

コスト漏れ検出（1 ツール）

ツール	説明
metrx_run_cost_leak_scan	エージェントフリート全体を対象とする、7 項目の包括的なコスト漏れ監査

アトリビューション（3 ツール）

ツール	説明
metrx_attribute_task	ROI 追跡のため、エージェントのアクションをビジネス成果に関連付け
metrx_get_task_roi	エージェントの投資収益率を算出 — コストと関連付けられた成果を比較
metrx_get_attribution_report	信頼度スコアと主な貢献者を含む、複数ソースのアトリビューションレポート

アラート設定（1 ツール）

ツール	説明
metrx_configure_alert_threshold	メール、Webhook、自動一時停止に対応したコストまたは運用アラートのしきい値を設定

ROI 監査（1 ツール）

ツール	説明
metrx_generate_roi_audit	AI エージェントフリートの、取締役会向け ROI 監査レポート

アップグレードの正当性（1 ツール）

ツール	説明
metrx_get_upgrade_justification	現在の使用パターンに基づく、プランのアップグレード向け ROI レポート

プロンプト

一般的なワークフロー向けに、あらかじめ用意されたプロンプトテンプレートです。

プロンプト	説明
analyze-costs	包括的なコスト概要 — 支出の内訳、主なエージェント、最適化の機会
find-savings	最適化の機会を発見 — モデルのダウングレード、キャッシュ、ルーティング
cost-leak-scan	無駄な支出のパターンをスキャン — リトライの集中、過大なコンテキスト、モデルのミスマッチ

例

「支出額はいくらですか？」

User: What was my AI cost this week?
→ metrx_get_cost_summary(period_days=7)

Total Spend: $234.56 | Calls: 2,450 | Error Rate: 0.2%
├── customer-support: $156.23 (1,800 calls)
└── code-generator: $78.33 (650 calls)

💡 Switch customer-support from GPT-4 to Claude Sonnet: Save $42/week

「コスト削減の方法を見つけてください」

User: Am I overpaying for my agents?
→ metrx_compare_models(models=["gpt-4o", "claude-3-5-sonnet", "gemini-1.5-pro"])

Model Comparison (per 1M tokens):
├── gpt-4o: $2.50 in / $10.00 out
├── claude-3-5-sonnet: $3.00 in / $15.00 out
└── gemini-1.5-pro: $3.50 in / $10.50 out

「より安価なモデルをテストしてください」

User: Test Claude 3.5 Sonnet against my GPT-4 setup
→ metrx_create_model_experiment(agent_id="agent_123",
    model_a="gpt-4o", model_b="claude-3-5-sonnet-20241022", traffic_split=10)

Experiment started: 90% GPT-4o, 10% Claude 3.5 Sonnet
Check back in 14 days for statistical significance.

関連ツール：コスト漏れ検出

このリポジトリには @metrxbot/cost-leak-detector も含まれています。LLM API ログをスキャンして無駄な支出を検出する、無料のオフライン CLI です。アカウント登録不要、クラウド不要で、データがマシンの外に送信されることもありません。

npx @metrxbot/cost-leak-detector demo

7 項目（アイドル状態のエージェント、プレミアムモデルの過剰使用、キャッシュの未設定、高いエラー率、コンテキストのオーバーフロー、予算の未設定、裁定取引の機会）をチェックし、数秒でスコア付きレポートを作成します。完全なドキュメントをご覧ください。

設定

API キー（必須）

サーバーは次の順に API キーを探します。

1. METRX_API_KEY 環境変数
2. ~/.metrxrc ファイル（--auth で作成）

npx @metrxbot/mcp-server --auth を実行してキーを保存するか、環境変数を直接設定してください。

変数	必須	説明
METRX_API_KEY	はい*	Metrx API キー（無料で取得）
METRX_API_URL	いいえ	API のベース URL を上書き（デフォルト：https://metrxbot.com/api/v1）

*--auth を実行済みの場合は不要です。キーは ~/.metrxrc から自動的に読み込まれます。

CLI フラグ

フラグ	説明
--demo	サンプルデータで開始 — API キーやアカウント登録は不要
--auth	対話型ログイン — ブラウザーを開き、キーを検証して ~/.metrxrc に保存
--test	API キーと接続を検証

レート制限

ツールごとに 1 分あたり 60 リクエストです。上限を引き上げるには、[email protected] までお問い合わせください。

開発

git clone https://github.com/metrxbots/mcp-server.git
cd mcp-server
npm install
npm run typecheck
npm test

貢献

ガイドラインについては CONTRIBUTING.md をご覧ください。

リンク

• ウェブサイト: metrxbot.com
• ドキュメント: docs.metrxbot.com
• npm: @metrxbot/mcp-server
• Smithery: metrxbot/mcp-server
• サポート: [email protected]

名前について

製品名は Metrx（metrxbot.com）です。npm のスコープは @metrxbot、Smithery の掲載名は metrxbot/mcp-server です。GitHub の組織名は metrxbots（末尾に s が付きます）。これは、GitHub ではすでに metrxbot が使われていたためです。各プラットフォームで metrxbot と metrxbots の表記が混在していても、同じプロジェクトです。GitHub の名前空間に関する制約によるものです。

ライセンス

MIT — LICENSE をご覧ください。

💬 フィードバック

Metrx は役に立ちましたか？　良かった点も悪かった点も、ぜひお聞かせください。

• GitHub Discussions: スレッドを立てる — 質問、アイデア、開発中のものについて
• バグ報告: Issue を作成する
• 簡単なフィードバック: Product Hunt の掲載ページにコメントをお寄せください

インストール後に問題が発生した場合は、何が起きたかお知らせください。すべての報告に目を通しています。