CCTV VMS MCP

🚀 MCP サーバ - VMS 統合

このプロジェクトは、CCTV 録画プログラム (VMS) に接続し、録画およびライブビデオストリームを取得するためのモデルコンテキストプロトコル (MCP) サーバです。また、特定のチャンネルのライブまたは再生ダイアログを表示するなど、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 に接続します。

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