Spot AI MCP (Unofficial)

io.github.phil-bryant由 GitHub 帳號 phil-bryant 發布v0.3.0更新於 Oct 24, 2026

Unofficial community MCP server for the Spot AI camera and video-intelligence REST API. Read-only.

發布方自己的服務:Spot

已驗證STDIO僅桌面安全與監控資料與分析

概覽

AI 產生的概覽

非官方的 Spot AI 攝影機與影像智慧 REST API 唯讀 MCP 伺服器,讓助理瀏覽攝影機、區域與智慧分析報告。

可以做什麼
  • 列出地點、攝影機、單一攝影機詳情與已啟用攝影機數量,以及錄影設備
  • 查看某台攝影機上定義的區域
  • 依日期範圍取得人員、車輛或堆高機的計數、閒置與在場事件
  • 取得車牌辨識攝影機的車牌辨識報告
  • 為最多四台攝影機產生即時影像觀看連結
  • 透過通用介面呼叫任何已文件化的 v1 或 v2 GET 路徑
適用情境
適合讓助理回答關於 Spot AI 攝影機部署的問題,例如有哪些攝影機及其位置、某段期間的活動統計、車牌讀取紀錄,或取得即時影像連結,同時不授予其對組織的寫入權限。
執行需求
以 Python 3.9+ 套件透過 stdio 在本機執行(uvx 或 pip install spot-ai-mcp,或 python3 -m spot_ai_mcp)。需要將 Spot AI API 金鑰放入 SPOT_AI_API_KEY 環境變數,也可選用透過 SPOT_AI_OP_BIN、SPOT_AI_OP_ITEM 與 SPOT_AI_OP_FIELD 變數設定的金鑰取得指令。需要能連線至 Spot AI API 的網路。
安裝前請注意
需要 Spot AI API 金鑰,且必須在主控台為其加上授權角色,否則各資源端點會回傳空清單。金鑰會以 bearer 權杖形式傳送給 Spot AI API。伺服器設計為唯讀,但有一個工具會發出 POST 請求以產生即時觀看連結,通用 GET 介面則可觸及任何已文件化的 API 路徑。此伺服器為非官方專案,與 Spot AI 無隸屬關係。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Spot AI MCP (Unofficial),將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

spot-ai-mcp

Unofficial community MCP server for the Spot AI camera / video-intelligence REST API. Not affiliated with or endorsed by Spot AI.

Single-file, stdio transport, no dependencies beyond Python 3.9+. Read-only by design: it can browse cameras and intelligence data but can never modify anything in your Spot AI org. Every tool wraps a GET endpoint except get_live_stream_urls, which wraps POST /v1/cameras/live — a read-like POST that only generates a viewing URL. All tools declare the readOnlyHint: true MCP annotation.

Install

bash
uvx spot-ai-mcp

or pip install spot-ai-mcp, or run straight from a checkout with python3 -m spot_ai_mcp (no dependencies to install).

Register with Claude Code:

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

API key

Create a key in the Spot AI dashboard's API settings, then add an authorization (a role, e.g. Owner, optionally scoped) on the key's settings page. A key without a role returns empty lists from every resource endpoint while get_camera_count still works — that's the tell.

The server resolves the key lazily on the first API call:

  1. SPOT_AI_API_KEY environment variable — the normal path.
  2. Optionally, a secret-helper command, so the key never sits in an env var or config: the server runs $SPOT_AI_OP_BIN -f $SPOT_AI_OP_ITEM $SPOT_AI_OP_FIELD (defaults 1psa -f spot.ai api_key, per 1psa, a vault-scoped 1Password service-account CLI). Point these at any command with the same flag convention.

The key is never written to disk or config by this server.

Tools

ToolWhat it does
list_locationsLocations the key can see (paginated)
list_camerasCameras with status, location, IP, MAC (paginated)
get_cameraOne camera by id
get_camera_countNumber of enabled cameras in the org
list_appliancesIntelligent Video Recorders (paginated)
get_zonesZones defined on a camera
get_intelligenceCounting / idle / presence events for people, vehicles, or forklifts over a date range
get_lpr_reportLicense-plate-recognition report for an LPR camera
get_live_stream_urlsLive-stream viewing URL for up to 4 cameras
spot_api_getEscape hatch: GET any documented /v1/ or /v2/ path

Notes

  • Dual-era MCP server: speaks both the modern per-request protocol (server/discover, spec 2026-07-28) and the legacy initialize handshake (2024-11-05 through 2025-06-18), so old and new clients both work.
  • Base URL is https://dev-api.spot.ai, auth is Authorization: Bearer <key>.
  • Cloudflare in front of the API rejects Python's default user agent with error 1010; the server sends User-Agent: spot-ai-mcp/<version>.
  • Endpoint index: https://developers.spot.ai/llms.txt (append .md to any docs URL for markdown, including the OpenAPI definition per endpoint).

License

MIT

來源:README.md,提交 110c90e

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.3.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Spot 整合