集成: AI 助手

连接 AI 助手

Agent DVR 可以直接从 AI 助手（如 Claude、ChatGPT、Cursor 和 VS Code Copilot）使用。用自然语言提问 - "我昨晚收到了什么警报？"、"显示今早走道摄像头发生了什么"、"禁用车库里的摄像头" - 助手会从您的直播摄像头、录像文件和警报日志中回答，包括图像。

这是通过模型上下文协议 (MCP)实现的，MCP 是助手用来连接外部工具的开放标准。Agent DVR 在两个地方提供 MCP 服务器，您可以根据需要将您的助手连接到其中一个：

  • 内置于 Agent DVR（本地端点）：由您本地网络上的服务器提供。不需要账户或订阅。适用于在同一台计算机或 LAN 上运行的助手。
  • 通过 iSpyConnect.com（云端点）：通过与网络门户和移动应用相同的远程访问来访问您的服务器，可从任何地方访问，无需端口转发。需要 iSpyConnect 订阅。这是用于 claude.ai、ChatGPT 和手机的选项。

两者都公开相同的工具集。需要 Agent DVR 8.0.3 或更高版本。

本地端点

每个 Agent DVR 服务器都在其本地 Web 服务器上的 /mcp 处提供 MCP，因此如果您在 http://localhost:8090 打开 Agent DVR 用户界面，端点为 http://localhost:8090/mcp（从局域网上的另一台计算机使用您的服务器地址和端口，例如 http://192.168.1.10:8090/mcp）。默认情况下此功能处于启用状态，可以在 服务器设置 - 本地服务器中使用 AI 助手 (MCP) 端点关闭。

访问遵循与其余 本地 API 完全相同的规则：从您自己的网络无需登录，除非启用了 保护 API，在这种情况下助手必须发送管理员用户的用户名和密码（大多数 MCP 客户端允许您添加 授权标头）。来自网络外部的连接另外需要 许可证，与端口转发访问用户界面相同。

Claude Code

claude mcp add --transport http agentdvr http://localhost:8090/mcp

Cursor

添加到 .cursor/mcp.json（或通过设置 - MCP）：

{ "mcpServers": { "agentdvr": { "url": "http://localhost:8090/mcp" } } }

VS Code（Copilot）

添加到 .vscode/mcp.json：

{ "servers": { "agentdvr": { "type": "http", "url": "http://localhost:8090/mcp" } } }

Claude Desktop

Claude Desktop 应用程序无法直接调用您自己计算机上的服务器，因此它使用一个小扩展来为您完成此操作。下载 AgentDVR.mcpb，然后在 Claude Desktop 中打开"设置"-"扩展"，将文件拖到页面上。它会在已启用状态下安装并连接到 http://localhost:8090/mcp；只有当您的服务器在另一台计算机上或已启用"保护 API"时，才点击"配置"。Claude 在每次工具首次使用时会请求权限 - 选择"始终允许"以停止提示。

Claude Desktop 对于每个不是从 Anthropic 自己的目录安装的扩展都会显示红色警告。这对此文件来说是正常的；该扩展仅与您提供的地址通信。

其他助手

任何支持 HTTP 上 MCP（"可流式 HTTP"）的客户端都可以使用相同的 URL。在助手的设置中查找"MCP 服务器"、"连接器"或"工具"。

Claude 网页版和移动应用，以及 ChatGPT，完全无法访问您自己网络上的服务器；它们使用云端点。

云端点

使用 iSpyConnect 订阅，您的服务器也可以通过以下地址访问：

https://www.ispyconnect.com/mcp

将该 URL 作为自定义连接器或 MCP 服务器添加到您的助手中（例如 claude.ai 和 Claude 应用中的"设置 - 连接器"，或 ChatGPT 和 Cursor 中的等效选项）。助手会打开 iSpyConnect 登录页面；登录后，选择是否允许控制以及查看，然后点击允许。无需进行其他配置：连接到您账户的每个已启用远程访问的 Agent DVR 服务器都是可用的，如果您有多个服务器，助手会询问您指的是哪一个。

请求通过 Web 门户使用的同一中继传输，因此无需进行端口转发，您的服务器永远不会暴露到互联网。当您的订阅过期时，访问权限停止，每个助手的访问权限可随时从助手自己的连接器设置中移除。

您的服务器必须处于运行状态并连接到 iSpyConnect（本地用户界面中的挂锁图标显示远程连接状态）。服务器设置中的阻止外部访问也会阻止此端点。

辅助工具的功能

助手可以使用一套专门构建的工具，而不是原始API，因此响应速度快且成本低：

  • 查看：列出服务器和设备（包括位置和状态），获取活动摘要（每个摄像头每小时的录制文件和警报，以及检测到的内容），在时间窗口内列出录制文件，将整个窗口一览无余地显示为帧网格，将摄像头在一天内显示为帧时间轴，从单个录制文件中采样帧，获取摄像头的实时快照，读取警报日志，并获取在网页界面中打开录制文件的链接。
  • 控制：启用和禁用服务器、应用配置文件、启用或禁用设备、改变录制模式、打开或关闭警报和检测器、将PTZ摄像头移动到预设位置，以及API中的其他状态更改。
  • 其他一切：当没有专门工具适用时，助手可以调用的进一步读取和控制命令的目录（系统统计、设备的完整状态、PTZ预设等）。

助手无法删除录像文件或照片、更改设备或服务器配置、添加或移除设备或重启服务器：无论使用哪个端点，这些命令故意不提供。在云端点上，查看和控制是单独的权限，您在登录页面上授予这些权限，使用受到速率限制以保护中继。

示例提示词

  • "过去24小时内有人来过前门吗？给我看看。"
  • "今天早上有哪些鸟来过喂食器？"
  • "今天车道有多繁忙，什么时候？"
  • "给我看看后花园这一整天。什么时候开始下雨的？"
  • "我昨天有什么警报，其中有任何人员吗？"
  • "现在谁在前门？"
  • "哪些摄像头离线？"
  • "我们要出门了 - 用离家配置文件启动所有设备。"
  • "禁用家庭位置中的所有摄像头。"
  • "给我发送快递员的剪辑链接。"

预设工作流

服务器还提供提示词模板，支持提示词的助手（Claude Desktop、Claude Code、Cursor等）将其显示为斜杠命令或菜单中的选项。每个模板都运行一个完整的多步骤工作流并报告结果：

  • morning_briefing - 摄像头从上个晚上以来拍摄到的内容：活动、警报、显著人员、车辆和动物，以及摄像头状态。
  • door_report - 谁来过门开关声摄像头，包括时间、每位访客的操作和每个剪辑的链接。
  • wildlife_report - 摄像头拍摄到哪些动物和鸟类，识别精度取决于录像的清晰度。
  • camera_health - 检查每个服务器和摄像头是否离线、已禁用、出错或摄像头是否没有活动。
  • day_in_review - 摄像头在一整天内的内容显示为帧时间轴，并附带场景如何变化的叙述。

故障排除

  • 助手无法连接到本地端点：在浏览器中检查 URL - http://localhost:8090/mcp 应该有响应（错误消息可以接受；"连接被拒绝"则不行）。确保端口与"服务器设置"中的"本地服务器"匹配，并且端点在那里已启用。
  • 401 未授权：保护 API 已启用，所以助手必须发送管理员用户的凭证，或者你是从网络外部连接的。
  • 403 禁止访问：在没有许可证的情况下从网络外部连接。改用 云端点。
  • 404 未找到：端点在"服务器设置"中已关闭，或服务器版本早于 8.0.3。
  • 云端点显示服务器离线：服务器未连接到 iSpyConnect。检查本地 UI 中的挂锁图标，并确保"阻止外部访问"已关闭。
  • 查看助手正在执行的操作：在"服务器设置"中将"记录日志"设置为调试，然后从"服务器菜单"打开日志。在本地端点，每个请求和工具调用都会使用"MCP"前缀记录，包括参数和所需时间。通过云端点，工具在 iSpyConnect.com 上运行，服务器只能看到它们发送的各个命令，这些命令使用"RelayApi"前缀记录。