OpenRouter 工作台 Local

OpenRouter ワークベンチ — Local MCP

MCP stdio 経由でローカル実行し、SQLite を使って記録を保存する、個人向けの完全な費用分析、レポート、コスト実験、モデルプリセットのツールです。Sites 版と同じ 28 個のツールを含みます。cyuanxv がメンテナンスしています：X / Twitter @cyuanxv。OpenRouter の公式製品ではないサードパーティープロジェクトです。

0.6.0-alpha.3 アルファテスト版です。ローカル版にはウェブサイト、バックグラウンドタスク、自動 Telegram 送信は付属しません。レポート生成、通知の申告、実際の送信結果の記録機能は備えていますが、有料推論、チャージ、Key の変更、本番ルーティングの切り替えは実行しません。

インストール（中国語）

Node.js 22.22+（22 系）または 24+ が必要です。22.22.2、24.16.0 でテスト済みです。一部の Node バージョンでは、SQLite の実験的機能に関するメッセージが stderr に出力されます。

新しい空のディレクトリで、固定バージョンを npm からインストールします（GitHub Release tarball も利用できます）：

npm install --ignore-scripts @cyuanxv/[email protected]

ローカル MCP stdio に対応したクライアントに、次の設定を追加します。Node とインストールファイルには、ご自身のコンピューター上の絶対パスを指定してください。Key はクライアントのセキュアな環境設定で入力し、実際の秘密鍵をチャット、Git、ターミナルコマンドに貼り付けないでください。

{
  "mcpServers": {
    "openrouter-analytics-mcp-local": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/install/node_modules/@cyuanxv/openrouter-analytics-mcp/dist/stdio.js"],
      "env": {
        "OPENROUTER_WORKBENCH_DATA_DIR": "/absolute/path/to/dedicated-private-data",
        "OPENROUTER_MANAGEMENT_KEY": "REPLACE_IN_CLIENT_SECRET_SETTINGS"
      }
    }
  }
}

データディレクトリには、本ツール専用の絶対パスを指定してください。ルートディレクトリ、ホームディレクトリそのもの、ソースコードディレクトリは指定しないでください。起動時にディレクトリの権限を 0700、データベースファイルの権限を 0600 に設定します（Windows では ACL が非公開であることを使用者が確認する必要があります）。データベースファイル名は workbench.sqlite です。シンボリックリンクのディレクトリ、シンボリックリンクまたはハードリンクのデータベースは拒否されます。ディレクトリ設定の不足、権限不足、移行の失敗があると起動に失敗し、設定値は表示されません。

まず routerlens_status を呼び出してください。mode=local-stdio、adapter_version=0.6.0-alpha.3、version は共有コアのバージョン 0.5.0 のままです。authentication_verified=false は Sites のクラウド認証がないことを示します。connectivity_verified=false は上流への接続をテストしていないことを示します。アカウント関連ツールの実際の成功によってのみ、ご自身の Key が使用可能であることを確認できます。Key がなくてもローカル記録の管理や公開モデルディレクトリへのアクセスはできますが、請求情報の照会はエラーになります。既存の呼び出しとの互換性を保つため、routerlens_status などのツール ID は維持されています。

インストールと設定のセルフチェック

ローカルの npm インストールディレクトリから実行します：

./node_modules/.bin/openrouter-analytics-mcp doctor
./node_modules/.bin/openrouter-analytics-mcp doctor --offline
./node_modules/.bin/openrouter-analytics-mcp doctor --json
./node_modules/.bin/openrouter-analytics-mcp doctor --help

完全なソースコードからビルドする場合は、packages/local-mcp で node dist/stdio.js doctor を実行できます。同じパッケージを引数なしで実行した場合は、引き続き通常の MCP サービスが起動します。

• Node のバージョン、Key の設定と Management 権限、基本的なアカウント情報の読み取り、データディレクトリの権限を確認し、問題と解決方法を中国語で説明します。
• デフォルトでは固定の OpenRouter HTTPS アドレスにのみ GET /api/v1/key、GET /api/v1/credits を送信します。リクエストは最大 2 件で、それぞれの待機時間は最大 5 秒です。通常の Key または権限が確認できない場合は、残高の照会を続行しません。
• --offline はネットワークに接続せず、ローカル設定のみを確認します。Key の有効性やアカウントへの接続可否は確認できません。
• 現在のプロセスから OPENROUTER_MANAGEMENT_KEY と OPENROUTER_WORKBENCH_DATA_DIR を読み取ります。ターミナルが MCP クライアント内の秘密の設定を自動的に取得することはありません。Key をコマンド引数として渡したり、Git に書き込んだり、チャットに貼り付けたりしないでください。
• Key、アカウント識別子、残高は出力しません。モデルの呼び出し、Key の変更、ディレクトリの作成、ファイルへの試し書き、データベースのオープン、権限の変更は行いません。ディレクトリ権限の確認は、ディスク容量、データベースの整合性、移行の成功を検証するものではありません。
• ディレクトリ設定がない場合はエラーになります。ディレクトリがまだ作成されていなくても親ディレクトリにアクセスできる場合は「確認待ち」と表示されます。通常の起動による作成後に、再度確認してください。Windows の非公開 ACL は自動検証されません。
• 終了コード 0：基本チェックに合格。1：設定または権限のエラーを検出。2：ネットワークのタイムアウト、オフライン、レート制限、作成待ちのディレクトリなどにより、完全に検証できなかった場合。--json は同じ中国語の診断結果と安定したエラーコードを出力するため、秘匿情報を除いた問題報告を送信できます。

詳しくは、リポジトリの中国語のトラブルシューティングをご覧ください。

データと実行上の境界

• データはご自身の SQLite に永続保存されます。アカウントの照会では OpenRouter にアクセスし、返されるデータは MCP クライアントのデータポリシーにも従います。
• 同じローカルユーザー、または十分なファイル権限を持つプログラムから、データベースにアクセスできる可能性があります。記録には費用、リクエスト識別子、手動のメモ、送信結果が含まれる場合があるため、公開リポジトリにコミットしないでください。
• すべてのインスタンスを停止してから、データディレクトリ全体をバックアップしてください。アップグレード前にもバックアップしてください。パッケージをアンインストールしてもデータベースは削除されません。プロセスは SIGINT/SIGTERM を受け取ったとき、またはクライアントが終了したときにデータベースを閉じます。
• コンピューターのシャットダウン後やプロセスの終了後は、スケジュールされたタスクを実行し続けることはできません。ローカル版は Telegram を自動送信しません。シミュレーションによる送信結果は、実際の送信記録として扱えません。
• ChatGPT クラウドからローカルの stdio プロセスを直接起動することはできません。クラウドで実行する必要がある場合は、引き続き Sites 版を使用してください。本パッケージは公開 HTTP エンドポイントを提供せず、ブラウザーから渡される Sites の ID ヘッダーも使用しません。

完全なソースコードからビルド

完全なソースコードパッケージの packages/local-mcp で実行します：

npm ci --ignore-scripts
npm run build
npm test
npm pack --ignore-scripts

ビルドでは ../../services/routerlens を再利用するため、このサブディレクトリだけをコピーしてソースコードからビルドすることはできません。生成される .tgz には実行ファイルと移行ファイルが含まれるため、インストール後に完全なソースコードツリーや build の実行は必要ありません。

英語

個人向け Sites 版の 28 個すべてのツールを備えた、ローカル stdio MCP サーバーです。OpenRouter のコスト分析、呼び出しメタデータ、異常調査、保存済みレポート、実験、バージョン管理されたルーティングプリセットを利用できます。Node.js 22.22+（22.x）または 24+、ご自身の OpenRouter アカウント、アカウント照会用のご自身の Management Key が必要です。

空のディレクトリに npm install --ignore-scripts @cyuanxv/[email protected] を実行して、固定されたアルファ版をインストールします。ローカル MCP クライアントを設定して、絶対パスで指定した Node.js を使い、インストール済みの dist/stdio.js を実行します。OPENROUTER_WORKBENCH_DATA_DIR には、専用の非公開ディレクトリの絶対パスを設定してください。OPENROUTER_MANAGEMENT_KEY は、クライアントの秘密情報設定から指定します。ダウンロードしたリリース tarball を npm でインストールすることもできます。

SQLite の記録はプロセスの再起動後も保持され、パッケージを削除しても残ります。すべてのインスタンスを停止してから、データディレクトリをバックアップしてください。ダッシュボード、HTTP リスナー、Sites 認証、組み込みスケジューラー、自動 Telegram 配信はありません。ChatGPT のクラウドコネクターではありません。有料推論、Key の書き込み、本番ルーティングの変更は実行されません。返されるデータは、お使いの MCP クライアントのポリシーにも従います。

npm と GitHub で公開アルファ版を提供しており、公式 MCP Registry には io.github.cyuanxv/openrouter-analytics-mcp として登録されています。リポジトリの公開および検証記録をご覧ください。Apache-2.0。OpenRouter とは独立したプロジェクトです。

インストール診断

パッケージのインストール後に ./node_modules/.bin/openrouter-analytics-mcp doctor を実行してください。ソース全体からビルドする場合は、まずビルドしてから packages/local-mcp で node dist/stdio.js doctor を実行してください。--offline を指定するとネットワークリクエストを行いません。--json を指定すると、構造化された診断情報を中国語で出力します。0.6.0-alpha.2 以降で利用できます。

このチェックでは、対応する Node バージョン、Management Key の識別情報、アカウントのクレジット情報を読み取る基本的な権限、およびディレクトリへのアクセスを検証します。呼び出すのは固定の HTTPS /api/v1/key および /api/v1/credits GET エンドポイントのみです。レスポンスサイズとタイムアウトには上限があり、リダイレクトには追従しません。キー、残高、アカウントの識別情報、生の上流エラーは出力しません。フォルダーの作成、ファイルの書き込み、データベースのオープン、権限の変更、キーの変更、モデルの呼び出しは行いません。アナリティクスへのアクセス、データベースの整合性、マイグレーションの成功、空きディスク容量、Windows ACL のプライバシーは保証しません。終了コード：0 = 基本チェックに合格、1 = 設定／認証エラー、2 = 検証が不完全。ターミナル環境と MCP クライアント環境は別々です。

リリースリンク / 公開リンク

インストールパッケージ、ソースコード、登録識別子：

• リポジトリ： https://github.com/cyuanxv/openrouter-analytics-mcp
• npm： https://www.npmjs.com/package/@cyuanxv/openrouter-analytics-mcp
• MCP Registry 名： io.github.cyuanxv/openrouter-analytics-mcp
• CLI： openrouter-analytics-mcp