CCTV VMS MCP

🚀 MCP 服務器 - VMS 集成

本項目是一個模型上下文協議 (MCP) 服務器，它能夠連接到 CCTV 錄像程序 (VMS)，用於檢索錄製和即時視頻流。此外，還提供了控制 VMS 軟件的工具，例如顯示特定頻道的即時或回放對話框，為視頻監控管理提供了便利。

✨ 主要特性

• 檢索視頻通道信息，涵蓋連接和錄製狀態。
• 獲取特定頻道的錄製日期和時間。
• 從視頻頻道獲取即時或錄製的圖像。
• 顯示特定頻道和時間戳的即時視頻流或回放對話框。
• 控制 PTZ（ pan 高度鏡頭）攝像頭，使其移動到預設位置。
• 具備全面的錯誤處理和日誌記錄功能。

📦 安裝指南

先決條件

• 需要 Python 3.12+ 版本。
• 安裝 vmspy 庫（用於 VMS 集成）。
• 安裝 Pillow 庫（用於圖像處理）。

安裝步驟

1. 安裝 UV 包管理器

在 PowerShell 中運行以下命令以安裝 UV：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

有關其他安裝方法，請參閱 官方 UV 文檔。

2. 安裝 VMS 服務器

下載並安裝 VMS 服務器：http://surveillance-logic.com/en/download.html （在使用此 MCP 服務器之前需要）

3. 安裝 Python 依賴項

下載 vmspy 庫：vmspy1.3-python3.12-x64.zip 將內容提取到您的 mcp_vms 目錄中。

mcp-vms 目錄結構應如下所示：

mcp-vms/
├── .gitignore
├── .python-version
├── LICENSE
├── README.md
├── pyproject.toml
├── uv.lock
├── mcp_vms.py            # 服務器實現的主要文件
├── mcp_vms_config.py     # VMS 連接配置
├── vmspy.pyd             # VMS Python 庫
├── avcodec-61.dll        # FFmpeg 庫
├── avutil-59.dll
├── swresample-5.dll
├── swscale-8.dll

📚 詳細文檔

MCP 服務器配置

如果您想在 Claude 桌面中使用 mcp-vms，需要設置 claude_desktop_config.json 文件如下：

{
  "mcpServers": {
    "vms": {
      "command": "uv",
      "args": [
        "--directory",
        "X:\\path\\to\\mcp-vms",
        "run",
        "mcp_vms.py"
      ]
    }
  }
}

VMS 連接配置

服務器使用以下默認配置連接到 VMS：

• mcp_vms_config.py

vms_config = {
    'img_width': 320,
    'img_height': 240,
    'pixel_format': 'RGB',
    'url': '127.0.0.1',
    'port': 3300,
    'access_id': 'admin',
    'access_pw': 'admin',
}