Spot AI MCP (Unofficial)

Name: Spot AI MCP (Unofficial)
Author: phil-bryant

本地服务

github.com/phil-bryant安全08 周前更新

代码仓库

关于 Spot AI MCP (Unofficial)

Spot AI MCP 是一个非官方、只读的 Spot AI 摄像头与视频智能 API MCP 服务，供 MCP 客户端查询摄像头和事件数据。它通过 stdio 提供工具，且不会修改组织数据。

主要功能

01浏览位置与摄像头
02查看摄像头状态和详情
03查询人员、车辆及叉车事件
04获取车牌识别报告
05生成实时视频流查看网址
06读取文档中的 API 路径

适用场景

01盘点可访问位置和摄像头
02查看指定摄像头的区域配置
03按日期范围检查视频智能事件
04获取摄像头实时流查看网址

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.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
limit	number	否	每页最大结果数
cursor	string	否	来自先前响应中 'next' 字段的分页游标

详细介绍

spot-ai-mcp

面向 Spot AI 摄像头／视频智能 REST API 的非官方社区 MCP 服务。与 Spot AI 无关联，也未获其认可。

单文件，使用 stdio 传输，除 Python 3.9+ 外无其他依赖。设计上仅支持只读：可以浏览摄像头和智能分析数据，但绝不会修改 Spot AI 组织中的任何内容。除 get_live_stream_urls（封装 POST /v1/cameras/live，这是一个类似读取的 POST 请求，仅用于生成观看 URL）外，所有工具都封装 GET 端点。所有工具都声明了 readOnlyHint: true MCP 注解。

安装

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 调用时按需解析密钥：

SPOT_AI_API_KEY 环境变量——常规方式。
可选的密钥助手命令，这样密钥就不会保存在环境变量或配置中：服务会运行 $SPOT_AI_OP_BIN -f $SPOT_AI_OP_ITEM $SPOT_AI_OP_FIELD （默认值为 1psa -f spot.ai api_key，参见 1psa，这是一个限定到保险库的 1Password 服务账户 CLI）。可以将这些变量指向任何采用相同标志约定的命令。

此服务绝不会将密钥写入磁盘或配置。

工具

工具	功能
`list_locations`	密钥可访问的位置（分页）
`list_cameras`	摄像头及其状态、位置、IP、MAC（分页）
`get_camera`	按 ID 获取单个摄像头
`get_camera_count`	组织中已启用摄像头的数量
`list_appliances`	智能视频录像机（分页）
`get_zones`	摄像头上定义的区域
`get_intelligence`	指定日期范围内的人、车辆或叉车计数／闲置／出现事件
`get_lpr_report`	LPR 摄像头的车牌识别报告
`get_live_stream_urls`	最多 4 台摄像头的直播观看 URL
`spot_api_get`	备用入口：对任意已记录的 `/v1/` 或 `/v2/` 路径执行 GET 请求

说明

双时代 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（在任何文档 URL 后追加 .md 即可获取 Markdown，包括各端点的 OpenAPI 定义）。