MCP Web Cam Server

A Model Context Protocol (MCP) server for controlling webcams. This server enables LLMs to capture photos, record videos, and manage camera settings through the MCP protocol.

Installation as MCP Server

For Claude Desktop App

Option 1: Using npx (Recommended)

Add to your Claude Desktop configuration:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "webcam": {
      "command": "npx",
      "args": [
        "-y",
        "@kmizu/mcp-web-cam"
      ]
    }
  }
}

Then restart Claude Desktop.

Option 2: Manual Installation

Install the dependencies and build:

git clone https://github.com/mizushima/mcp-web-cam.git
cd mcp-web-cam
npm install
npm run build

Add to your Claude Desktop configuration:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "webcam": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-web-cam/dist/index.js"]
    }
  }
}

Restart Claude Desktop

For Other MCP Clients

The server communicates via stdio, so you can run:

node /path/to/mcp-web-cam/dist/index.js

Features

Photo Capture: Take high-quality photos with customizable settings
Video Recording: Record videos with various formats and codecs
Camera Management: List available cameras and adjust settings
Image Processing: Basic image manipulation capabilities
Cross-platform: Supports Linux, Windows, and macOS

Installation

Global Installation (for use outside MCP)

npm install -g @kmizu/mcp-web-cam

Local Development

npm install
npm run build

Usage

As an MCP Server

The server can be used with any MCP-compatible client:

npm start

Development

npm run dev    # Watch mode for development
npm run build  # Build TypeScript
npm run typecheck  # Type checking only

Available Tools

`select_camera`

Open a modern web UI to select from available cameras with live preview.

Features:

Live preview of all connected cameras
WebRTC-based preview when available
Fallback to snapshot mode for compatibility
Persistent camera selection

`get_current_camera`

Get the currently selected camera device.

`capture_photo`

Take a photo using the webcam.

Parameters:

width (optional): Image width in pixels (320-3840)
height (optional): Image height in pixels (240-2160)
quality (optional): Image quality (1-100)
format (optional): Image format ('jpeg', 'png', 'bmp')
return_type (optional): How to return data ('location', 'buffer', 'base64')
device (optional): Camera device ID

`start_recording`

Start recording video from the webcam.

Parameters:

duration (optional): Recording duration in seconds (1-3600)
fps (optional): Frames per second (1-60)
format (optional): Video format ('mp4', 'avi', 'mkv')
codec (optional): Video codec (e.g., 'libx264', 'libx265')

`stop_recording`

Stop the current video recording.

`list_cameras`

List all available camera devices.

`get_camera_settings`

Get current camera settings.

Parameters:

device (optional): Camera device ID

`set_camera_settings`

Adjust camera settings like brightness, contrast, etc.

Parameters:

device (optional): Camera device ID
brightness (optional): Brightness level (0-100)
contrast (optional): Contrast level (0-100)
saturation (optional): Saturation level (0-100)
hue (optional): Hue adjustment (-180 to 180)
gamma (optional): Gamma correction (1-500)
sharpness (optional): Sharpness level (0-100)
whiteBalance (optional): White balance in Kelvin (2000-10000)
exposure (optional): Exposure compensation (-10 to 10)
gain (optional): Gain level (0-100)
focus (optional): Focus level (0-100, 0=auto)

Resources

The server provides the following resources:

webcam://cameras: List of available camera devices
webcam://captures: List of captured photos
webcam://recordings: List of video recordings

Dependencies

Required System Dependencies

Linux

# Ubuntu/Debian
sudo apt-get install v4l-utils ffmpeg

# CentOS/RHEL
sudo yum install v4l-utils ffmpeg

Windows

FFmpeg (download from https://ffmpeg.org/)
Windows Media Foundation

macOS

brew install ffmpeg

File Structure

mcp-web-cam/
├── src/
│   ├── index.ts              # Main MCP server
│   ├── webcam/
│   │   ├── controller.ts     # Camera control logic
│   │   └── types.ts          # TypeScript type definitions
│   ├── tools/                # MCP tool implementations
│   │   ├── capture.ts        # Photo capture tool
│   │   ├── recording.ts      # Video recording tools
│   │   └── camera.ts         # Camera management tools
│   └── types/
│       └── node-webcam.d.ts  # Type declarations
├── captures/                 # Captured photos (auto-created)
├── recordings/               # Video recordings (auto-created)
└── dist/                     # Compiled JavaScript

License

MIT