MCP Server - VMS Integration

1[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/jyjune-mcp-vms-badge.png)](https://mseep.ai/app/jyjune-mcp-vms)
2 
3[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/jyjune/mcp_vms)](https://archestra.ai/mcp-catalog/jyjune__mcp_vms)
4 
5# MCP Server - VMS Integration
6 
7A Model Context Protocol (MCP) server designed to connect to a CCTV recording program (VMS) to retrieve recorded and live video streams. It also provides tools to control the VMS software, such as showing live or playback dialogs for specific channels at specified times.
8 
9![diagram](https://github.com/jyjune/mcp_vms/blob/main/mcp_vms_diagram.png?raw=true)
10 
11## Features
12 
13- Retrieve video channel information, including connection and recording status.
14- Fetch recording dates and times for specific channels.
15- Fetch live or recorded images from video channels.
16- Show live video streams or playback dialogs for specific channels and timestamps.
17- Control PTZ (Pan-Tilt-Zoom) cameras by moving them to preset positions.
18- Comprehensive error handling and logging.
19 
20## Prerequisites
21 
22- Python 3.12+
23- `vmspy` library (for VMS integration)
24- `Pillow` library (for image processing)
25 
26## MCP-server Configuration
27 
28If you want to use `mcp-vms` with Claude desktop, you need to set up the `claude_desktop_config.json` file as follows:
29 
30```json
31{
32  "mcpServers": {
33	"vms": {
34	  "command": "uv",
35	  "args": [
36		"--directory",
37		"X:\\path\\to\\mcp-vms",
38		"run",
39		"mcp_vms.py"
40	  ]
41	}
42  }
43}
44```
45 
46## VMS Connection Configuration
47 
48The server uses the following default configuration for connecting to the VMS:
49- mcp_vms_config.py
50```python
51vms_config = {
52    'img_width': 320,
53    'img_height': 240,
54    'pixel_format': 'RGB',
55    'url': '127.0.0.1',
56    'port': 3300,
57    'access_id': 'admin',
58    'access_pw': 'admin',
59}
60```
61 
62## Installation
63 
64### 1. Install UV Package Manager
65Run the following command in PowerShell to install `UV`:
66 
67```shell
68powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
69```
70 
71For alternative installation methods, see the [official UV documentation](https://docs.astral.sh/uv/getting-started/installation/).
72 
73### 2.Install VMS Server
74   Download and install the VMS server from:  
75   [http://surveillance-logic.com/en/download.html](http://surveillance-logic.com/en/download.html)
76   (Required before using this MCP server)
77 
78### 3.Install Python Dependencies
79   Download the vmspy library:  
80   [vmspy1.4-python3.12-x64.zip](https://sourceforge.net/projects/security-vms/files/vmspy1.4-python3.12-x64.zip/download)
81   Extract the contents into your `mcp_vms` directory
82 
83The mcp-vms directory should look like this:
84 
85```shell
86mcp-vms/
87├── .gitignore
88├── .python-version
89├── LICENSE
90├── README.md
91├── pyproject.toml
92├── uv.lock
93├── mcp_vms.py            # Main server implementation
94├── mcp_vms_config.py     # VMS connection configuration
95├── vmspy.pyd             # VMS Python library
96├── avcodec-61.dll        # FFmpeg libraries
97├── avutil-59.dll
98├── swresample-5.dll
99├── swscale-8.dll
100```
101[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/7027c4cd-a9c1-43dd-9e74-771fc7cc42da)
102