agent-costcenter

agent-costcenter-mcp

エージェントごとのコスト配分と予算管理を行う MCP サーバーです。AI エージェント群全体を対象に、「最もコストがかかっているエージェントはどれか？」に回答します。

機能

• エージェントごとのコスト追跡 — エージェントを登録し、LLM とツールの呼び出しを記録して、エージェントごとの支出を確認できます
• 組み込み料金表 — ファジーマッチングに対応した 11 種類のモデル（Claude、GPT、Gemini、DeepSeek）
• 予算管理 — 上限とアラートを設定し、残りの予算を確認して、予算超過時に警告またはブロックできます
• コストレポート — エージェント、チーム、プロジェクトごと、または全体の内訳を表示します。モデルごとの詳細と割合も含まれます
• 異常検知 — 支出が 2 倍以上急増したエージェントを自動的に検出します
• モデル比較 — 使用したすべてのモデルについて、1,000 トークンあたりのコストを比較できます

クイックスタート

npx agent-costcenter-mcp

Claude Desktop

{
  "mcpServers": {
    "agent-costcenter": {
      "command": "npx",
      "args": ["agent-costcenter-mcp"]
    }
  }
}

ツール

ツール	説明
register_agent	チーム、プロジェクト、モデル、予算上限を指定してエージェントを登録します
log_llm_call	LLM の呼び出しを記録します。料金表からコストを自動計算します
log_tool_call	ツール／API 呼び出しのコストを記録します
get_cost_report	エージェント、チーム、プロジェクトごと、または全体のコスト内訳を表示します
set_budget_alert	支出のしきい値を設定します（警告またはブロック）
check_budget	エージェントが予算内かどうかを確認します
get_cost_anomalies	支出が異常に急増したエージェントを検出します
compare_models	モデル間のコスト効率を比較します

リソース

URI	説明
costcenter://summary	すべてのエージェントの現在の総支出
costcenter://pricing	組み込みのモデル料金表

組み込み料金（100 万トークンあたり）

モデル	入力	出力
claude-opus-4	$15.00	$75.00
claude-sonnet-4	$3.00	$15.00
claude-haiku-4	$0.80	$4.00
gpt-4o	$2.50	$10.00
gpt-4o-mini	$0.15	$0.60
gpt-4.1	$2.00	$8.00
gpt-4.1-mini	$0.40	$1.60
gemini-2.5-pro	$1.25	$10.00
gemini-2.5-flash	$0.15	$0.60
deepseek-v3	$0.27	$1.10
deepseek-r1	$0.55	$2.19

モデル名はファジーマッチングで照合されます（大文字と小文字を区別せず、バージョンの接尾辞を除去します）。

ワークフローの例

1. register_agent(agent_id="researcher", team="discovery", model="claude-sonnet-4", budget_cap_usd=10)
2. log_llm_call(agent_id="researcher", model="claude-sonnet-4", input_tokens=5000, output_tokens=2000)
3. log_tool_call(agent_id="researcher", tool_name="web_search", duration_ms=1200, cost_usd=0.01)
4. check_budget(agent_id="researcher")
5. get_cost_report(scope="all")
6. get_cost_anomalies()
7. compare_models()

開発

npm install
npm test
npm run dev  # watch mode

ライセンス

MIT