MCP Server - VMS Integration

Name: MCP Server - VMS Integration
Author: jyjune

@jyjune

Repository

About MCP Server - VMS Integration

MCP server for controlling and accessing a video surveillance system

#cctv #security #surveillance #ip-camera

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Server - VMS Integration?

MCP Server - VMS Integration is a Model Context Protocol (MCP) server that connects to a CCTV recording program (VMS) to retrieve recorded and live video streams and control VMS software, such as showing live or playback dialogs for specific channels at specified times. It is intended for users who need to integrate video surveillance capabilities into MCP-compatible assistants.

How to use MCP Server - VMS Integration?

Install Python 3.12+, the VMS server from surveilance-logic.com, and the vmspy library from sourceforge. Configure the MCP server in claude_desktop_config.json using the uv command pointing to the mcp_vms.py file. Adjust VMS connection settings in mcp_vms_config.py (default IP 127.0.0.1, port 3300, credentials admin/admin).

Key features of MCP Server - VMS Integration

Retrieve video channel information, including connection and recording status.
Fetch recording dates and times for specific channels.
Fetch live or recorded images from video channels.
Show live video streams or playback dialogs for specific channels and timestamps.
Control PTZ cameras by moving them to preset positions.
Comprehensive error handling and logging.

Use cases of MCP Server - VMS Integration

Query camera recording status and retrieve stored footage for a given date.
Display a live video feed from a specific channel in a chat interface.
Trigger PTZ camera movement to a preset location via natural language commands.
Integrate VMS playback controls into an AI assistant for security monitoring.
Automate retrieval of snapshots from multiple cameras during incident review.

FAQ from MCP Server - VMS Integration

What VMS software does the server work with?

The server works with the CCTV recording program available at surveilance-logic.com (VMS server must be installed separately).

What are the runtime requirements?

Python 3.12 or later is required, along with the vmspy and Pillow libraries. The VMS server itself must be installed and running.

How do I configure the VMS connection?

Edit mcp_vms_config.py to set the VMS server IP, port, access ID, and password. The default configuration uses localhost on port 3300 with credentials admin/admin.