mcpField
S
Spot AI MCP (Unofficial)

Spot AI MCP (Unofficial)

ローカル
github.com/phil-bryantセキュリティ08 週間前に更新
リポジトリ

Spot AI MCP (Unofficial) について

Spot AI MCPは、Spot AIのカメラや映像インテリジェンスデータを照会する非公式の読み取り専用MCPサーバーです。stdio経由でツールを提供し、組織のデータは変更できません。

主な機能

  1. 01ロケーションとカメラの一覧
  2. 02カメラの状態と詳細の確認
  3. 03人物・車両・フォークリフトのイベント照会
  4. 04ナンバープレート認識レポートの取得
  5. 05ライブストリーム視聴URLの生成
  6. 06ドキュメント化されたAPIパスの呼び出し

活用シーン

  1. 01アクセス可能なロケーションとカメラの棚卸し
  2. 02カメラに設定されたゾーンの確認
  3. 03期間を指定した映像インテリジェンスイベントの確認
  4. 04カメラのライブストリーム視聴URLの取得

MCP 対応

Spot AI REST APIの読み取り専用照会機能をMCPツールとして公開します。stdioでMCPクライアントと通信し、ツールは読み取り専用として宣言されています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "phil-bryant-spot-ai": {
      "command": "uvx",
      "args": [
        "spot-ai-mcp"
      ],
      "env": {
        "SPOT_AI_API_KEY": "<SPOT_AI_API_KEY>"
      }
    }
  }
}
起動コマンドuvx spot-ai-mcp
設定が必要な環境変数
SPOT_AI_API_KEYシークレットSpot AI API key (create one in the Spot AI dashboard API settings and add an authorization role to it)

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypispot-ai-mcp0.3.0

ツール

10

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
limitnumberいいえページあたりの最大結果数
cursorstringいいえ前回のレスポンスの 'next' フィールドから取得したページネーションカーソル

詳細

spot-ai-mcp

Spot AI のカメラ／動画インテリジェンス REST API 向けの、非公式なコミュニティ製 MCP サーバーです。Spot AI とは提携しておらず、Spot AI の推奨を受けたものでもありません。

単一ファイルで動作し、stdio トランスポートを使用します。Python 3.9+ 以外の依存関係はありません。 設計上、読み取り専用です。カメラやインテリジェンスデータを参照できますが、Spot AI 組織のデータを変更することはできません。get_live_stream_urls は POST /v1/cameras/live をラップしますが、これは視聴 URL を生成するだけの読み取りに近い POST であり、それ以外のすべてのツールは GET エンドポイントをラップします。すべてのツールで MCP アノテーション readOnlyHint: true を宣言しています。

インストール

uvx spot-ai-mcp

または、pip install spot-ai-mcp を実行するか、チェックアウトしたディレクトリから直接 python3 -m spot_ai_mcp を実行します（インストールが必要な依存関係はありません）。

Claude Code に登録するには：

claude mcp add spot-ai -s user -e SPOT_AI_API_KEY=YOUR_KEY -- uvx spot-ai-mcp

API キー

Spot AI ダッシュボードの API 設定でキーを作成し、キーの設定ページで認可（Owner などのロール。必要に応じてスコープを指定）を追加してください。ロールが設定されていないキーでは、get_camera_count は動作しますが、すべてのリソースエンドポイントから空のリストが返されます。これが見分けるポイントです。

サーバーは最初の API 呼び出し時にキーを遅延取得します。

  1. 環境変数 SPOT_AI_API_KEY — 通常はこちらを使用します。
  2. 必要に応じて、キーを環境変数や設定ファイルに保存せずに済むシークレットヘルパーコマンドを使用できます。サーバーは $SPOT_AI_OP_BIN -f $SPOT_AI_OP_ITEM $SPOT_AI_OP_FIELD を実行します（デフォルトは 1psa -f spot.ai api_key。1psa は、Vault のスコープに対応した 1Password サービスアカウント用 CLI です）。同じフラグの規則を使用する任意のコマンドを指定できます。

このサーバーがキーをディスクや設定ファイルに書き込むことはありません。

ツール

ツール機能
list_locationsキーで参照できるロケーション（ページネーション対応）
list_camerasステータス、ロケーション、IP、MAC を含むカメラ一覧（ページネーション対応）
get_cameraID を指定してカメラを 1 台取得
get_camera_count組織内の有効なカメラの数
list_appliancesIntelligent Video Recorders（ページネーション対応）
get_zonesカメラに設定されたゾーン
get_intelligence指定した期間の、人、車両、フォークリフトに関するカウント／アイドル／存在イベント
get_lpr_reportLPR カメラのナンバープレート認識レポート
get_live_stream_urls最大 4 台のカメラのライブストリーム視聴 URL
spot_api_getエスケープハッチ：ドキュメント化された任意の /v1/ または /v2/ パスに GET

注記

  • 2 世代の MCP に対応するサーバーです。最新のリクエストごとのプロトコル（server/discover、仕様 2026-07-28）と、旧式の initialize ハンドシェイク（2024-11-05 から 2025-06-18）に対応しているため、新旧両方のクライアントで動作します。
  • ベース URL は https://dev-api.spot.ai、認証方式は Authorization: Bearer <key> です。
  • API の前段にある Cloudflare は、Python のデフォルトのユーザーエージェントをエラー 1010 で拒否します。そのため、サーバーは User-Agent: spot-ai-mcp/<version> を送信します。
  • エンドポイント一覧：https://developers.spot.ai/llms.txt（OpenAPI 定義を含め、ドキュメント URL の末尾に .md を追加すると Markdown 形式になります）。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。