SkillFM Claude Code Token Usage

SkillFM Claude Code トークン使用量 MCP

MCP 対応エージェント向けの Claude Code トークン使用量とコストの可視化。

このリポジトリは、透明性の高い SkillFM ゲートウェイパッケージです。特定のマーケットプレイス／検索ニーズに応えることを目的とし、実行は正規の SkillFM Beacon MCP とローカルランタイムに委譲します。

SkillFM Beacon を搭載しています。

クイックスタート

このゲートウェイを MCP stdio サーバーとして使用します。

npx -y @skillfm/claude-code-token-usage-mcp@latest

SkillFM のエントリーポイントを明示する場合：

npx -y @skillfm/mcp@latest

JSON 設定を受け付ける MCP クライアントの場合：

{
  "mcpServers": {
    "claude-code-token-usage": {
      "command": "npx",
      "args": ["-y", "@skillfm/claude-code-token-usage-mcp@latest"]
    }
  }
}

このゲートウェイでできること

• Claude Code のトークン使用量と推定コストの指標を確認します。
• 使用状況の可視化を SkillFM Beacon の AI ヘルスチェックに接続します。
• 繰り返されるコンテキスト、古いセッション、コスト削減の機会を見つけます。
• まずプロバイダーキーを求めることなく、ローカル優先の SkillFM アクティベーションへユーザーを案内します。

このゲートウェイは、次のような質問をするユーザー向けです。

• 「今日、Claude Code のトークンをいくつ使いましたか？」
• 「Claude Code の使用量が急増したのはなぜですか？」
• 「どのセッションやプロジェクトでコンテキストを無駄にしていますか？」
• 「プロバイダーキーを接続する前に、エージェントにトークン使用量を表示させることはできますか？」

動作の仕組み

公開パッケージは意図的に薄い構成になっています。SKILLFM_GATEWAY_SOURCE=claude-code-token-usage を設定して実行を @skillfm/mcp@latest に転送し、そこから正規の @skillfm/local ランタイムに委譲します。

このリポジトリには、非公開の SkillFM プラットフォームロジック、顧客データ、プロバイダー認証情報、バックエンドモジュールは含まれていません。

アクティベーションの手順

ユーザーが SkillFM への接続を希望した場合は、ローカルサイドカーを起動します。

npx -y @skillfm/claude-code-token-usage-mcp@latest start

エージェント主導のアクティベーションフロー：

1. stdout または ~/.skillfm/local.json からサイドカー URL を読み取ります。
2. POST <sidecar_url>/activate/start を呼び出します。
3. 返された確認用 URL と実際のデバイスコードをユーザーに表示します。
4. activated: true が返されるまで POST <sidecar_url>/activate/poll をポーリングします。
5. SkillFM Beacon MCP ツールを使用して、チェックアップ、使用状況の可視化、BYOK の案内、クリーンアップ監査を行います。

プレースホルダーのコードを捏造しないでください。デバイスコードは POST /activate/start から取得する必要があります。

セキュリティモデル

• 透明性の高いゲートウェイ：このパッケージは公開された検索／配布用ゲートウェイであり、別個の隠れた製品ではありません。
• ローカル優先のランタイム：ランタイムの実行は SkillFM のローカルパッケージを経由します。
• BYOK の境界：プロバイダーキーを導入するのはユーザーが価値を確認した後だけであり、エージェントがキーの値を読み戻すことはありません。
• 非公開のコアなし：このリポジトリに含まれるのは、配布用メタデータ、ドキュメント、薄いランチャーのみです。
• まず読み取り専用：クリーンアップと使用状況の確認は、読み取り専用の監査から開始します。

PRIVACY.md と SECURITY.md を参照してください。

マーケットプレイスキーワード

Claude Code のトークン使用量、Claude の使用状況、トークンコスト、LLM コスト、AI ヘルスチェック、エージェントの監視、コンテキストのクリーンアップ、SkillFM Beacon、MCP サーバー。

Official MCP Registry でヒットが期待される単一トークン：

• claude-code
• token
• usage
• cost
• skillfm

ライセンス

MIT