Video Still Capture MCP

A Model Context Protocol server for accessing and controlling webcams via OpenCV

Overview

Video Still Capture MCP is a Python implementation of the Model Context Protocol (MCP) that provides AI assistants with the ability to access and control webcams and video sources through OpenCV. This server exposes a set of tools that allow language models to capture images, manipulate camera settings, and manage video connections. There is no video capture.

Examples

Here are some examples of the Video Still Capture MCP server in action:

Orange Example

Magnet Example

Installation

Prerequisites

• Python 3.10+
• OpenCV (opencv-python)
• MCP Python SDK
• UV (optional)

Installation from source

git clone https://github.com/13rac1/videocapture-mcp.git
cd videocapture-mcp
pip install -e .

Run the MCP server:

mcp dev videocapture_mcp.py

Integrating with Claude for Desktop

macOS/Linux

Edit your Claude Desktop configuration:

# Mac
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Linux
nano ~/.config/Claude/claude_desktop_config.json 

Add this MCP server configuration:

{
  "mcpServers": {
    "VideoCapture ": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "numpy",
        "--with",
        "opencv-python",
        "mcp",
        "run",
        "/ABSOLUTE_PATH/videocapture_mcp.py"
      ]
    }
  }
}

Ensure you replace /ABSOLUTE_PATH/videocapture-mcp with the project’s absolute path.

Windows

Edit your Claude Desktop configuration:

nano $env:AppData\Claude\claude_desktop_config.json

Add this MCP server configuration:

{
  "mcpServers": {
    "VideoCapture": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "numpy",
        "--with",
        "opencv-python",
        "mcp",
        "run",
        "C:\ABSOLUTE_PATH\videocapture-mcp\videocapture_mcp.py"
      ]
    }
  }
}

Ensure you replace C:\ABSOLUTE_PATH\videocapture-mcp with the project’s absolute path.

Using the Installation Command

Alternatively, you can use the mcp CLI to install the server:

mcp install videocapture_mcp.py

This will automatically configure Claude Desktop to use your videocapture MCP server.