TokenZero

TokenZero のツール

OpenAI、Anthropic、Gemini の請求額を削減する、BYOK 対応ゲートウェイ TokenZero のオープンソースツールです。

• @tokenzero/mcp は、Claude Code、Cursor、Windsurf、Cline 向けの stdio MCP サーバーです。開いているプロジェクトをローカルで監査してトークンの無駄を見つけ、モデルの代替候補の料金を比較し、リクエストボディをキャッシュしやすい形式にします。
• @tokenzero/cli は、コードを変更せずにプロジェクトをゲートウェイに接続し、LLM トークンの無駄をローカルで監査して、使用状況を表示し、署名済みの節約レシートを検証します。
• アナライザー（src/audit-core.ts）は、CLI、ホスト型リポジトリ監査、PR のコスト差分チェックで使用される、トークンの無駄を検出する静的監査ツールです。すべてお使いのマシン上で実行されます。
• 料金表（src/pricing.ts）には、すべての見積もりの計算基準となる標準料金が記載されています。バージョン管理され、日付が付いています。

プロジェクトを監査する

npx -y @tokenzero/cli audit            # local, nothing is uploaded
npx -y @tokenzero/cli audit --json
npx -y @tokenzero/cli audit --fail-over 30   # CI gate: exit 1 above 30% recoverable
git diff origin/main | npx -y @tokenzero/cli audit --diff - --format markdown

監査は静的なヒューリスティックです。コードを読み取り、トラフィックは読み取りません。数値は標準料金に基づく見積もりです。実際にリクエストがゲートウェイを経由すると、署名済み台帳によって節約額が検証されます。

検出対象：

• キャッシュ指示（Anthropic の cache_control、OpenAI のプレフィックス安定性）を付けずに送信される大きな静的プロンプト
• 呼び出し元とは別の場所に定義され、キャッシュがまったくないプロンプトテンプレート
• 抽出や分類のように見えるプロンプトに対するフロンティアモデルの使用
• ループ内の LLM 呼び出し（Batch API または共有プレフィックスキャッシュの候補）
• 料金が未設定、または提供終了したモデル ID

ライブラリおよび SDK のリポジトリは検出後、呼び出し元が選択した内容がそのまま渡されるため、検出結果の重大度を下げます。

すべてのプルリクエストをチェックする（GitHub Action）

# .github/workflows/tokenzero.yml
name: TokenZero cost check
on: pull_request
permissions: { contents: read, pull-requests: write }
jobs:
  cost-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 0 }
      - uses: tokenzero-ai/tokenzero/action@v0

PR ごとにコメントを 1 件投稿し、プッシュのたびに更新します。ランナーの外部に情報が送信されることはありません。入力と出力については、action/README.md をご覧ください。

コーディングエージェントから使用する（MCP）

claude mcp add tokenzero -- npx -y @tokenzero/mcp          # Claude Code

{ "mcpServers": { "tokenzero": { "command": "npx", "args": ["-y", "@tokenzero/mcp"] } } }

audit_repo_token_waste と calculate_model_arbitrage は、すべてお使いのマシン上で実行されます。optimize_prompt_payload は、指定したリクエストボディを TokenZero サービス（TOKENZERO_URL が設定されていない場合は https://tokenzero.sh）に送信するため、秘密情報を含めないでください。

プロジェクトをゲートウェイに接続する

npx -y @tokenzero/cli init

init はローカルで監査を行い、ワークスペースを作成し、同意を得たうえで .env に OPENAI_BASE_URL / ANTHROPIC_BASE_URL を追加します。プロバイダーのキーはそのまま中継され、保存されることはありません。

認証：ワークスペースキーは X-TokenZero-Key ヘッダーに指定してください（推奨）。コードを変更しない構成の場合、CLI でベース URL（/w/<key>/v1）に埋め込むこともできます。このような URL は秘密情報として扱い、漏えいした場合は tokenzero rotate-key を使用してください。

開発する

npm install
npm run build      # bundles cli/bin/tokenzero.mjs (single file, no runtime deps)
npm test

ライセンス：Apache-2.0 · [email protected]