SightRadar

SightRadar MCP サーバー

AI アシスタント向けの顔認識です。イベント写真にインデックスを付け、1 枚の自撮り写真から人物が写っている写真をすべて検索し、一括処理を実行し、ウェブフックや請求を管理できます。Claude、ChatGPT、Cursor、VS Code、またはあらゆるMCPクライアントから利用できます。

---

接続方法は 2 通りあります。どちらも同じツールを利用できます。

	リモート（ホスト型）	ローカル（このパッケージ）
URL／コマンド	https://mcp.sightradar.com/mcp	npx -y sightradar-mcp
サインイン	SightRadar アカウント（メールアドレスとパスワード、Google、またはメールリンク）、または Bearer トークンとしての API キー	SIGHTRADAR_API_KEY
インストール	不要	Node.js 20+
コンピューター上の画像	いいえ（URL または base64）	はい、file_path

リモートサーバー（推奨）

カスタムコネクターとして https://mcp.sightradar.com/mcp を追加します。初回の利用時にブラウザーで sightradar.com が開くので、サインインしてアシスタントに許可する操作を選択します。接続ごとに個別の取り消し可能なキーが発行され、API keys に MCP: <app name> として表示されます。

• Claude（claude.ai、Desktop）：Settings → Connectors → Add custom connector → URL を貼り付けます。
• ChatGPT：Settings → Apps & Connectors → Create → URL を貼り付け、認証方式に OAuth を選択します。
• Claude Code：claude mcp add --transport http sightradar https://mcp.sightradar.com/mcp
• Cursor（~/.cursor/mcp.json）／VS Code（.vscode/mcp.json、キー servers）：

  { "mcpServers": { "sightradar": { "url": "https://mcp.sightradar.com/mcp" } } }
  

API キーを使いたい場合は、サインインの代わりにヘッダーとして送信します。

{
  "mcpServers": {
    "sightradar": {
      "url": "https://mcp.sightradar.com/mcp",
      "headers": { "Authorization": "Bearer frs_your_key" }
    }
  }
}

ローカルサーバー

sightradar.com/dashboard/keys で API キーを作成し、次の手順を実行します。

{
  "mcpServers": {
    "sightradar": {
      "command": "npx",
      "args": ["-y", "sightradar-mcp"],
      "env": { "SIGHTRADAR_API_KEY": "frs_your_key" }
    }
  }
}

この設定ブロックは Claude Desktop（claude_desktop_config.json）、Cursor、Windsurf、Cline、およびほとんどのクライアントで使用できます。Claude Code の場合：

claude mcp add sightradar --env SIGHTRADAR_API_KEY=frs_your_key -- npx -y sightradar-mcp

変数	デフォルト
SIGHTRADAR_API_KEY	(必須)	API キー
SIGHTRADAR_SCOPES	read,search,write,delete	公開するツールグループです。all を指定すると account が追加され、read を指定すると読み取り専用サーバーになります。
SIGHTRADAR_FILE_ROOTS	ホームフォルダー	file_path で読み取り可能なフォルダー（macOS/Linux では :、Windows では ; で区切ります）。none を指定すると file_path が無効になります。
SIGHTRADAR_BASE_URL	https://api.sightradar.com	API のベース URL
SIGHTRADAR_TIMEOUT_MS	120000	リクエストごとのタイムアウト
SIGHTRADAR_DEBUG	未設定	各ツール呼び出しを標準エラー出力に記録します（引数や結果は記録しません）。

ツール

クレジット：100,000 クレジット = 1 米ドル。課金対象の各ツールは説明に料金を記載しており、再試行時に二重請求されないよう idempotency_key を受け付けます。

read — 無料

ツール
list_collections	コレクションの写真、顔、自撮りの件数。検索とページングに対応
get_collection	1 つのコレクションのステータスと件数（verify はベクトルストアから再集計します）
get_deletion_status	コレクション削除の進行状況
list_batches / get_batch / get_batch_photos	バッチジョブ、ステータス（一度に 1 件または最大 5000 件）、写真ごとの結果
list_webhooks / list_webhook_failures	Webhook エンドポイントとデッドレター化された配信
get_balance / get_usage	クレジット残高、利用状況の概要、日別の推移、またはストレージ

search — クレジットを消費します。データは保存しません

ツール	クレジット
search_faces	93	自撮り（または埋め込み）に写っている人物を含む、コレクション内のすべての写真を検索します
search_by_point_id	62	自撮りを再送信せずに、登録済みの自撮りを使った検索を再実行します
detect_faces	93	画像内の顔、バウンディングボックス、品質
compare_faces	画像あたり 93	2 つの顔が同一人物かどうかを判定します

write — クレジットを消費します／データを保存します

ツール	クレジット
index_photo	93	写真の顔をコレクションに保存します
register_selfie	93	人物の自撮りを保存し、ポイント ID と埋め込みを返します
submit_batch	写真あたり 62	最大 1000 件の写真 URL を受け付け、インデックス作成または照合をバックグラウンドで処理します
requeue_failed_batch_photos	写真あたり 62	バッチで失敗した写真を再試行します（プレビュー後に実行）
create_collection / recreate_collection	無料
create_webhook / replay_webhook_failures	無料	バッチおよび削除イベントの署名付き配信

delete — 無料

ツール
delete_collection	デフォルトでは 7 日間の復元期間付きで論理削除します。immediate または compliance を指定すると完全に消去します
restore_collection	論理削除を取り消します
delete_photo / restore_photo	1 枚の写真の顔を削除または復元します
delete_webhook	エンドポイントへの配信を停止します

account — 無料。ローカルサーバーではデフォルトで無効です

ツール
list_api_keys / create_api_key / revoke_api_key	API キー
get_profile / update_profile	名前と組織
get_billing_settings / update_auto_recharge / get_invoice	自動チャージ、注文、請求書 PDF
get_notification_settings / update_notification_settings / manage_notification_recipient	メール通知と追加の宛先
list_team_members	組織のメンバー

プロンプトとリソース

MCP プロンプトを表示するクライアント（Claude の「+」メニュー、/ コマンド）には、すぐに使える 3 つのワークフローが用意されています。

プロンプト	内容
find_person_in_event	残高を確認し、自撮りを使ってコレクションを検索して、一致する写真を一覧表示します
index_event_photos	写真の枚数に応じて index_photo または submit_batch を選び、開始前に料金を提示します
account_health	残高、最近の利用状況、失敗したバッチ写真、失敗した Webhook 配信

リソース：sightradar://docs/pricing-and-limits（操作ごとのクレジット、レート制限、画像と削除の制限）および sightradar://collections/{collection_id}（1 つのコレクションの件数。read スコープが必要です）。

画像

画像ツールでは、次のいずれか 1 つだけを指定します。

• image_url：公開されている http(s) URL。SightRadar が画像をダウンロードするため、インターネットからアクセス可能である必要があります。
• gcs_key：アカウントに設定された CDN 上のオブジェクトキー。
• image_base64：base64 形式のバイト列、または data: URL。リモートサーバーでは最大 10 MB、ローカルサーバーでは最大 30 MB を受け付けます。
• file_path（ローカルサーバーのみ）：SIGHTRADAR_FILE_ROOTS 内にある JPEG、PNG、WebP、GIF、BMP、TIFF、または HEIC ファイル。

ファイルと base64 データは、アップロードの前に実際の画像であることを確認します。

プロンプトの例

• 「wedding-2026-10 というコレクションを作成し、~/Pictures/wedding 内のすべての写真をインデックス化してください。」
• 「こちらは Priya の自撮り写真です。wedding-2026-10 の中で、彼女が写っている写真はどれですか？」
• 「この 600 件の写真 URL を marathon-7 に一括送信して、完了したら教えてください。」
• 「今週はクレジットをいくつ使い、何に使いましたか？」
• 「test-event コレクションを削除してください。」（アシスタントが最初に確認し、削除は 7 日間取り消せます。）

安全性

• ツールには MCP アノテーション（readOnlyHint、destructiveHint）が付与されるため、クライアントは破壊的な呼び出しの前に確認できます。
• デフォルトでは削除はソフト削除です。完全に消去するには、immediate または compliance を明示的に設定する必要があります。
• スコープによって接続で可能な操作が制限されます。read 専用の接続では、クレジットの消費やデータの変更はできません。
• ローカルサーバーは、シンボリックリンクを解決した後、SIGHTRADAR_FILE_ROOTS 内にある画像ファイルのみを読み取ります。
• API エラーはエラーコード、ヒント、リクエスト ID を含むツールの結果として返され、スタックトレースは返されません。

トラブルシューティング

表示される内容	意味
401 / unauthorized	API キーが取り消されたか、入力に誤りがあります。sightradar.com/dashboard/keys で新しいキーを作成してください。リモート接続の場合は、再接続してください。
402 / insufficient_credits	sightradar.com/dashboard/billing でクレジットを追加してください。
409 / duplicate_request_already_processed	この idempotency_key はすでに使用され、課金されています。先の呼び出しは成功しています。
file_path ... is outside the folders this server may read	フォルダーを SIGHTRADAR_FILE_ROOTS に追加してください（macOS/Linux では :、Windows では ; で区切ります）。
429	キーあたり毎秒 50 件、またはアカウントあたり同時に 10 件を超えています。時間をおいて再試行してください。

開発

npm install
npm test          # unit tests against a mocked API
npm run build
SIGHTRADAR_API_KEY=frs_... node scripts/smoke.mjs   # free live calls over stdio

createSightRadarServer({ api, scopes }) と TOOLS は、同じツールを別のホストに組み込むためにエクスポートされています。

リンク

• SightRadar · API ドキュメント · 料金
• Node.js SDK：npm の sightradar · Python SDK：PyPI の sightradar

MIT ライセンスです。