codex-usage-tracker MCPサーバー
コミット 2026年10月14日ローカルのCodexセッションのメタデータを分析し、トークン使用量、コスト、クレジット、およびツールの使用パターンに関する正確な事実を提供します。
別名 douglasmonsky/codex-usage-tracker
- スター
- 196
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年10月14日
- ライセンス
- MIT
codex-usage-tracker MCPとは
codex-usage-trackerはMCPサーバーです。 ローカルのCodexセッションのメタデータを分析し、トークン使用量、コスト、クレジット、およびツールの使用パターンに関する正確な事実を提供します。.
プロジェクトのREADMEから生成された概要
codex-usage-tracker MCP server について
この MCP server は、トークンの消費量とコストを把握するために、ローカルの Codex セッションのメタデータを分析することを開発者に可能にします。ローカルのセッションデータを、時間、ツール、クレジット、および許容範囲に関する具体的な事実へと変換します。Evidence Console と SQLite カーネルを提供することで、エージェントが一般的な要約に頼るのではなく、正確な使用パターンを探索し、説明できるようにします。
ユーザーは pipx を介して Python ランタイムをインストールし、リポジトリを Codex plugin marketplace のエントリとして追加します。設定が完了すると、この server はエージェントがクエリを実行できるローカルなツールカタログとして機能します。セッション、ターン、コール、ツール、リソース、許容範囲、トークン、クレジット、およびコストに関する事実を可視化します。このセットアップは、Codex work のリソース消費方法や予算への影響について、安定したエビデンスを必要とするユーザー向けに設計されています。
できること
- 1ツール使用パターンの監査特定のターン中にどのツールが呼び出され、いくつのトークンが使用されたかの内訳をリクエストします。
- 2Codex パフォーマンスの評価インストールされている Codex qualification のレイテンシと正確性をエージェントに分析させます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
自動チェック
実行日 2026年11月13日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能douglasmonsky/codex-usage-tracker is public and reachablegithub.com/douglasmonsky/codex-usage-tracker ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-14github.com/douglasmonsky/codex-usage-tracker ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るCodex Usage Tracker
Codex Usage Tracker is a local usage-data product for answering questions about how Codex work consumes tokens, time, tools, allowance, credits, and cost. It turns local session metadata into exact, bounded facts and stable evidence that an agent can explore and explain.
Current release and next direction
Version 0.28.0 is the current public release. Its six-tool MCP surface, Evidence Console, and SQLite kernel remain supported while the replacement is qualified.
The next product is a clean, agent-first kernel rather than a larger dashboard:
- fast recent-history setup with explicit 24-hour through all-time coverage;
- incremental reuse on every later invocation;
- exact session, turn, call, tool, resource, allowance, token, credit, and cost facts;
- compact named queries and stable evidence selectors;
- agent-owned interpretation instead of server-authored narrative findings;
- installed Codex qualification measured for latency, MCP calls, response bytes, model tokens, accuracy, and usefulness.
The 0.28 code remains a frozen oracle during the rewrite and is removed before the clean replacement release. The new runtime does not migrate or open its database.
Start with the documentation authority, read the
product direction, or follow the
clean-cutover roadmap. Progress is
tracked in the checkbox ledger, with one
complete contract per file under docs/roadmap/tasks/.
Install 0.28.0
Install the Python runtime into an isolated executable environment, then add the matching tagged repository as a Codex plugin marketplace:
pipx install "codex-usage-tracking==0.28.0"
codex plugin marketplace add douglasmonsky/codex-usage-tracker --ref v0.28.0
codex plugin add codex-usage-tracker@codex-usage-tracker
The plugin launches the codex-usage-tracker executable from the pipx
environment. Start a fresh Codex task after installation so it discovers the
new plugin tool catalog.
Develop
python3 -m venv .venv
.venv/bin/python -m pip install -e ".[dev]"
just v
Use synthetic fixtures only. Do not commit or share real Codex logs, prompts, responses, tool-output bodies, credentials, private paths, or local databases.
codex-usage-tracker MCPのよくある質問
バージョン 0.28.0 をインストールするにはどうすればよいですか?
pipx を使用して Python ランタイムをインストールし、リポジトリを Codex plugin marketplace として追加してから、プラグインを追加してください。
データを共有しても安全ですか?
いいえ、合成データ(synthetic fixtures)のみを使用してください。実際の Codex のログ、プロンプト、レスポンス、またはローカルデータベースをコミットしたり共有したりしないでください。