CCTV VMS MCP

CCTV VMS MCP

An MCP server connecting to a VMS to access live/recorded video streams and control.

11
Stars
3
Forks
0
Releases

Overview

This MCP server is designed to connect to a CCTV recording program (VMS) to retrieve both live and recorded video streams. It exposes MCP-compliant interfaces that allow clients to query channel information, monitor connection and recording status, and fetch available playback windows. In addition to streaming, it provides tools to control the VMS software, including showing live or playback dialogs for specific channels at given timestamps, and PTZ control to move cameras to preset positions. The server supports use cases such as on-demand live viewing, archival playback, and external camera control from application clients. Prerequisites include Python 3.12 or newer, along with vmspy for VMS integration and Pillow for image processing. A default VMS connection config is provided, including image dimensions, pixel format, URL, port, and credentials, and it can be customized. There is also an example Claude desktop integration config showing how to run the MCP server via uv in claude_desktop_config.json. The project emphasizes robust error handling and logging to aid reliability and debugging.

Details

Owner
jyjune
Language
Python
License
MIT License
Updated
2025-12-07

Features

Retrieve video channel information

Fetch channel connection status and recording state from the VMS.

Fetch recording dates and times

Query available recording dates and times for a given channel to enable playback.

Fetch live or recorded images

Obtain still images from live or archived video channels for preview or processing.

Show live streams and playback dialogs

Open live video streams or playback dialogs for a channel at a specified timestamp.

PTZ camera control

Move cameras to preset positions or adjust angles via PTZ controls.

Error handling and logging

Provide robust error handling and detailed logging to improve reliability and debugging.

Audience

DevelopersCreate MCP-based integrations to access VMS streams and control playback and PTZ features.
System IntegratorsIntegrate CCTV systems with MCP for centralized video access and VMS control.
Security TeamMonitor live/recorded feeds and manage VMS playback and PTZ from MCP.
AdministratorsConfigure and maintain MCP-VMS integration deployments.

Tags

MCPVMSCCTVlive streamsplaybackPTZimage processingvmspyPillowPythonintegrationvideo controlloggingerror handling