routerbase

routerbase

routerbase は、家庭用ルーターに関する次の 3 種類の質問に回答します。 モデルの工場出荷時のログイン情報（ゲートウェイ、ログインホスト、 ユーザー名／パスワード、認証情報の種類、リセット手順、および レコードの出典として記載されているメーカーの情報）、モデルが ユニバーサルなデフォルトパスワードを禁止する英国の PSTI と EU の CRA 規則に準拠しているかどうか、そして MAC アドレスのネットワーク ハードウェアを製造したメーカーです。 1 つのバイナリで、コマンドラインインターフェースと stdio MCP サーバーを提供します。

データはホスト型サービスに保存されています。routerbase はローカルの stdio サーバーで、各呼び出しを JSON-RPC の tools/call リクエストとして ssid.ai の MCP エンドポイント https://ssid.ai/mcp/http に転送します。 このワイヤ形式は、サービスの公開説明をもとに再構成したものです。 SSID_API_BASE（ホストまたは完全なエンドポイント URL）を使って接続先を変更できます。

読み取りツールはキーなしで無料で利用できます。SSID_API_KEY を設定すると レート制限が緩和され、設定されている場合は Bearer トークンとして送信されます。 submit_correction は異なります。アップストリームでは、この書き込みツールの 利用に Pro ティアが必要なため、SSID_API_KEY がない場合、routerbase は 理由を説明してリクエストを拒否し、何も送信しません。実際には送信されていない 修正を、送信済みと報告することはありません。

lookup_mac では、アドレスの分類を実際にローカルで行います。アドレスを解析して 正規化し（コロン、ハイフン、ドット、区切りなしの 16 進数形式に対応）、先頭オクテットの マルチキャストビットとローカル管理ビットを使って、マルチキャスト、ランダム化、 ユニバーサルのいずれかを判定します。解析できないアドレスは無効と判定します。 アップストリームから取得するのはベンダー／OUI の情報のみで、無効なアドレスが アップストリームに送信されることはありません。

インストール

npx @reneturcios/routerbase lookup_mac 00:1A:2B:3C:4D:5E

または、コンテナーイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/routerbase

コンテナーはデフォルトで MCP サーバーとして起動します（下記を参照）。 CLI として使うには、CLI 引数を渡してください。

CLI

routerbase get_router_defaults --slug <slug>
routerbase get_router_defaults --brand <brand> --model <model>
routerbase check_router_compliance --slug <slug>
routerbase lookup_mac 00:1A:2B:3C:4D:5E
routerbase submit_correction --slug <slug> --field gateway_ip \
  --proposed-value 192.168.0.1 --source-url https://example.com/manual

routerbase --version

コマンドが成功すると、結果が JSON として出力されます。終了コード： 成功時は 0、呼び出し失敗時（アップストリームのエラーや修正キーによる 制限を含む）は 1、使用方法のエラー時は 2 です。 get_router_defaults には --slug、または --brand と --model の両方が 必要です。指定が不足している場合は推測せず、正直にエラーを返します。

MCP サーバー

1 つのバイナリで、どちらのインターフェースも利用できます。mcp サブコマンドで stdio MCP サーバーが起動します。

npx -y @reneturcios/routerbase mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "routerbase": {
      "command": "npx",
      "args": ["-y", "@reneturcios/routerbase", "mcp"],
      "env": {
        "SSID_API_KEY": "your key, optional for read tools"
      }
    }
  }
}

ツール

ツール	入力	返される内容
get_router_defaults	slug、または brand + model	メーカーの情報源を明記した、そのモデルの工場出荷時ログイン情報レコード。
check_router_compliance	slug（必須）	ユニバーサルなデフォルトパスワードに関する英国の PSTI／EU の CRA 規則に対する、そのモデルの準拠状況。
lookup_mac	mac（必須）	ローカルでの分類（ユニバーサル／ランダム化／マルチキャスト／無効）、正規化されたアドレスと OUI、およびアップストリームのベンダーペイロード。
submit_correction	slug、field、proposedValue、sourceUrl（すべて必須）	出典を添えた修正を、検証のために送信待ちとして登録します。SSID_API_KEY が必要です（Pro ティア）。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。