openclaw-cost-tracker-mcp

OpenClaw用のトークンコストテレメトリ。ClaudeやMCP対応エージェントからクエリ可能です。 エージェント別・プロバイダー別のコスト配分、コスト急増の異常検知、モデルルーティングの推奨、30日間の予測機能を提供します。silentwatch-mcpおよびopenclaw-health-mcpのコンパニオンツールです。

機能概要

AIの本番環境では、複数のプロバイダー、数十のエージェント、数百のスキル呼び出しにわたってトークンコストが発生します。月末に請求書が届く頃には、「どこでコストがかかったのか？」という問いへの答えは10万行のログの中に埋もれてしまいます。このMCPサーバーは、そのデータをライブで可視化し、Claude内から平易な英語でクエリできるようにします。

> claude: where did our LLM spend go this week?
[MCP tools: cost_overview + top_cost_drivers]

Total spend last 7 days: $42.18
By provider:
  Anthropic    $30.40 (72%) — claude-sonnet-4 dominates
  OpenAI       $9.20  (22%) — chat-bot agent
  Gemini       $1.86  (4%)  — cron-summarizer (cheap-route working)
  Ollama       $0.00  (local, free)

Top 3 cost drivers:
  data-extraction-agent      $28.50 (68%)
  chat-bot                   $9.20  (22%)
  cron-summarizer            $1.86  (4%)

1 anomaly flagged — see find_cost_anomalies for details.

> claude: any cheaper-routing opportunities?
[MCP tool: model_routing_recommendations]

Recommendation: data-extraction-agent currently runs claude-sonnet-4
with avg 400-token completions — extraction-style work that
gemini-2.5-flash usually handles at ~95% quality for ~5% the cost.
Estimated savings: $27.10/30d if migrated. Test on a 10% slice first.

openclaw-cost-tracker-mcp を選ぶ理由

既存のツール（プロバイダーの請求ダッシュボード、汎用FinOpsツール、カスタムスクリプト）では対応できない3つの機能を提供します。

1. プロバイダー単位の合計だけでなく、エージェント単位でのコスト配分。 プロバイダーのダッシュボードには「Anthropicで$X使用」と表示されますが、6つのエージェントのうちどれがその78%を占めているかは分かりません。Cost trackerはOpenClawのリクエストごとのコストログJSONLを読み込み、agent_idを保持したまま集計します。

2. エージェントごとのコスト急増の異常検知。 チャットに12万トークンのテキストを貼り付けるだけで、通常の1週間分のトラフィック以上のコストがかかることがあります。デフォルトの「エージェントごとの中央値の3倍」というしきい値により、月末の請求書に載る前にそれらをフラグ立てします。

3. 実際の使用量に基づいたルーティングの推奨。 「より安いモデルを使う」といった一般的なアドバイスは役に立ちません。このサーバーは、ボリュームと完了トークン数のパターンから、より安価なプロバイダーでも同じ結果が得られる可能性が高い「特定のエージェント」を特定し、具体的な30日間の節約額を提示します。

OpenClawを本番環境で運用し、実際のコストを管理している本番AIオペレーターのために構築されました。

ツール一覧

リソース:

• cost://overview — 7日間のスナップショット

• cost://forecast — 30日間の予測

• cost://anomalies — 最近フラグ立てされた異常

プロンプト:

• diagnose-cost-spike — 最近のコスト急増の原因と対策を調査

• weekly-cost-digest — 200語程度の週次コストダイジェスト

クイックスタート

インストール

pip install openclaw-cost-tracker-mcp

Claude Desktopの設定

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) に以下を追加します：

{
  "mcpServers": {
    "openclaw-cost": {
      "command": "python",
      "args": ["-m", "openclaw_cost_tracker_mcp"],
      "env": {
        "OPENCLAW_COST_BACKEND": "mock"
      }
    }
  }
}

バックエンド

JSONLログ形式

各行は1つのJSONレコードです：

{"request_id":"req-abc123","timestamp":"2026-05-04T12:34:56Z","provider":"anthropic","model":"claude-sonnet-4","agent_id":"data-extraction-agent","skill_id":"extract-structured-data","prompt_tokens":8500,"completion_tokens":600,"total_tokens":9100,"cost_usd":0.0345,"duration_ms":4823}

OpenClawのデプロイメントがこの形式を出力しない場合は、プロバイダー呼び出しを小さなログシムでラップしてください（examples/にサンプルシムがあります）。

ロードマップ

スタックへの適応が必要ですか？

AIデプロイメントでOpenClawのコストログ形式を使用していない場合（異なるエージェントハーネス、カスタムログ、AWS Bedrockの計測、ベンダーの請求APIなど）でも、同様の配分・異常検知・ルーティングの可視化を実現したい場合は、カスタムMCP構築をご依頼ください。

依頼方法:

1. 件名を Custom MCP Build inquiry として temur@pixelette.tech までメールしてください。

2. スタックの説明（1段落）と検討中のティアを記載してください。

3. 2営業日以内に30分間のヒアリング用カレンダーリンクを返信します。

このサーバーは、本番AIインフラストラクチャMCPスイートの一部です。silentwatch-mcp（cronのサイレント障害検知）およびopenclaw-health-mcp（デプロイメントの健全性）と併せて、3つすべてをインストールすることで完全な運用可視性が得られます。

本番AI監査

本番環境でAIを運用しており、外部の専門家に準備状況を評価させ、既存の障害パターン（コスト超過は最も一般的なパターンの1つ）を特定し、是正計画を作成したい場合は以下をご検討ください：

同じメールアドレス：temur@pixelette.tech（件名：AI audit inquiry）までご連絡ください。

貢献

プルリクエストを歓迎します。バックエンドはプラグイン可能です。契約については src/openclaw_cost_tracker_mcp/backends/ を参照してください。

新しいバックエンドを追加するには：

1. backends/<your_backend>.py で CostBackend をサブクラス化する

2. get_entries() を実装する

3. backends/__init__.py に登録する

4. tests/test_backend_<your_backend>.py にテストを追加する

バグ報告や機能リクエストはGitHubのIssueを作成してください。

ライセンス

MIT — LICENSE を参照してください。

関連

• silentwatch-mcp — cronのサイレント障害検知

• openclaw-health-mcp — デプロイメントの健全性

• AI Production Discipline Framework — Notionテンプレート、$29 — これらのMCPツールが実装する手法（コスト超過はカタログ内のパターンP3.x）

• SPEC.md — 完全なサーバー設計

構築者: Temur Khan — 本番AIシステムの独立系専門家 連絡先: temur@pixelette.tech