Sigrank

SigRank CLI & MCP

ローカルの AI 利用状況を読み取り、トークンカスケードを確認し、必要に応じて署名済みスナップショットを SignalAF の SigRank リーダーボード に公開できます。

npx sigrank

ウェブサイト · クイックスタート · MCP の設定 · ツールとアダプターのリファレンス · プライバシー

できること

• 対応するローカル AI セッションログから利用状況のメタデータを読み取ります。
• 利用可能な各期間について、入力、出力、キャッシュ書き込み、キャッシュ読み取りの数を表示します。
• Yield、Leverage、Velocity、SNR、10xDEV をローカルで計算します。
• ターミナルダッシュボードと、AI クライアント向けの MCP ツールを提供します。
• 公開を選択した場合に限り、署名済みテレメトリを送信します。

これは、観測可能なトークン処理パターンを評価するものであり、モデルの品質、作業の品質、生産性、またはビジネス上の成果を評価するものではありません。ソースで個別に公開されていない指標を、アダプターが推定する場合があります。こうした制約については、アダプターのリファレンスに記載されています。

はじめに

Node.js 20 以降が必要です。グローバルインストールは不要です。

ローカルで確認する

npx sigrank                       # interactive dashboard in a terminal
npx sigrank board --once          # public leaderboard, one-shot
npx sigrank board --window 7d --once

ダッシュボードには、Dashboard、Trends、Compare、Board、Watch、Connect のタブがあります。1～6 または矢印キーでタブを切り替え、R で更新し、Q で終了します。

自分のスナップショットを公開する

1. signalaf.com にサインインし、Settings で接続コードを作成します。
2. このデバイスを登録し、ドライランのペイロードを確認します。
3. 公開する準備ができたら送信します。

npx sigrank enroll
npx sigrank submit --dry-run
npx sigrank submit

登録すると、デバイスの署名キーがオペレーターアカウントに紐付けられます。秘密鍵はデバイス上に保持されます。サーバーは送信されたテレメトリを検証して再スコアリングします。ローカルプレビューで公開順位が保証されるわけではありません。

繰り返し使用する場合は、任意でグローバルインストールすると、同じコマンドを利用できます。

npm install -g sigrank
sigrank

MCP クライアントを接続する

このサーバーをクライアントの MCP 設定に追加します。

{
  "mcpServers": {
    "sigrank": {
      "command": "npx",
      "args": ["-y", "sigrank"]
    }
  }
}

ターミナルを使わずに起動すると、エントリーポイントが自動的に MCP stdio サーバーを起動します。MCP ツール名はクライアントから呼び出すものであり、シェルコマンドではありません。

タスク	ツール
ローカルの利用状況を確認	tokenpull、rank_windows、tokenpull_compare
指定したカウントから計算	rank_paste、get_sigrank_standard_record
公開結果を読む	get_leaderboard、get_operator、discover_peers
変更の可能性を検討	diagnose_cascade、simulate_change、suggest_improvements
登録と送信	enroll、submit_verified

ツールの一覧、引数、アダプターのパスについては、CLI と MCP のリファレンスを参照してください。submit_verified による公開には confirm: true が必要です。dry_run: true を指定すると、公開せずにペイロードを確認できます。

コマンドガイド

コマンド	用途
sigrank	ターミナルダッシュボードを開く
sigrank board --once	公開リーダーボードを表示する
sigrank compare --platform codex	利用可能なローカルソース間でトークン数を監査する
sigrank watch --window 7d	ローカルの利用状況の更新を監視する
sigrank enroll	接続コードを使ってデバイスを紐付ける
sigrank submit --dry-run	署名済みの送信内容を確認する（送信はしない）
sigrank submit	検証済みの送信内容を公開する
sigrank proxy	任意のループバック利用状況プロキシを起動する
sigrank --help	現在のコマンドリファレンスを表示する

任意の使用量プロキシ

一部のクライアントは、プロバイダーから報告された使用量のすべてをセッションファイルに保存しません。クライアントがカスタム API ベース URL に対応している場合、sigrank proxy を使って、互換性のある Anthropic または OpenAI API トラフィックから使用量を取得できます。

プロキシはデフォルトで無効で、ループバックにのみバインドします。プロバイダー宛てのリクエスト／レスポンスの内容と認証情報をメモリ上で転送しますが、その内容は保存しません。ローカルの使用量ログには、トークン数とメタデータが含まれます。使用する前に、プライバシー契約をご確認ください。

計測の仕組み

4つのトークンの柱を使って計算します。

Yield (Υ) = (cache_read × output) / input²
Leverage  = cache_read / input
Velocity  = output / input
SNR       = output / (input + output)
10xDEV    = log₁₀(Leverage)

このパッケージは、sigrank CLI／MCP 互換コマンドを通じて、Upsilon 計測エンジンを配布します。SigRank は、SignalAF 上の公開リーダーボードおよび証明の場です。TTEOP はプロトコルのセマンティクスを定義し、MO§ES™ はガバナンスフレームワークです。

実装では、token-cascade を通じて tteop-spec に標準計算を委譲しています。TTEOP 実装プロファイルとプロトコル互換性に関する注記をご覧ください。

プライバシー

ローカルでの確認によって、使用量が公開されることはありません。署名付き送信には、4つの柱に加えて、アカウント／デバイス識別子、署名、プラットフォーム／バージョン情報、件数、レポートのメタデータが含まれます。登録時にはデバイスラベルも送信されます。

プロンプトのテキスト、レスポンスのテキスト、ソースコード、リポジトリの内容、ローカルファイルのパスは、ランキングへの送信ペイロードには含まれません。任意のプロキシによるコンテンツの一時的な処理は、保存または送信される内容とは別のものです。

ペイロードとプライバシーの詳細をお読みのうえ、送信される内容を確認するには submit --dry-run を使用してください。

開発

git clone https://github.com/SunrisesIllNeverSee/sigrank-mcp.git
cd sigrank-mcp
npm install
npm test
npm run test:packaged

ダッシュボードを表示するには、ターミナルで node index.mjs を実行するか、チェックアウトしたエントリポイントを MCP クライアントに設定してください。リリースバージョンは、リポジトリの明示的な公開ワークフローで管理されています。ドキュメントのコミットによって npm リリースが公開されることはありません。

関連プロジェクト

• sigrank-app — SignalAF のウェブサイト、プロフィール、公開 API、リーダーボード。
• token-cascade — このパッケージが使用する計測実装。
• TTEOP — プロトコルの仕様とセマンティクス。

貢献とセキュリティ

貢献ガイドをご覧ください。GitHub Issuesでバグを報告してください。脆弱性はセキュリティポリシーを通じて非公開で報告してください。

ライセンス

MIT。