Webcam MCP server

<!-- mcp-name: io.github.1019666077-bit/webcam -->

Webcam MCP 📸

MCP server for webcam access - capture photos and video for LLM agents

Fork notice. This is botbridge-webcam-mcp, a fork of

pavel-kirienko/webcam_mcp (MIT),

maintained by 1019666077-bit. It adds an

MCP Apps panel (webcam_panel). Install this distribution as

botbridge-webcam-mcp; the upstream distribution on PyPI is named

webcam-mcp. The Python import package is webcam_mcp.

Webcam MCP is a Model Context Protocol (MCP) server that gives LLM agents direct access to your webcam. It enables autonomous agents to capture photos and record video sequences, making it possible to debug cyberphysical systems, monitor environments, and interact with the physical world without human intervention.

Features:

• 📸 High-Resolution Photos: Capture still images
• 🎛️ MCP Apps panel (webcampanel)**: Free in-chat buttons (拍一张 / 再拍 / 关掉); Pro placeholders only
• 🎥 Video Recording: Record a sequence of frames over a specified duration
• 🌐 Remote Access: SSE transport for network-accessible deployment
• ⚙️ Configurable: Adjust resolution, camera index, and quality settings
• 🔌 Cross-Platform: Works on Linux, macOS, and Windows
• 🚀 Easy Integration: Simple MCP client configuration

Usage

Install:

pip install botbridge-webcam-mcp

Start the MCP server:

webcam-mcp

The server will start on http://0.0.0.0:8000/sse by default.

You can test the server using any MCP client, e.g., MCP Inspector (install via npx @modelcontextprotocol/inspector).

CLI options

Examples

# Start on custom port
webcam-mcp --port 9000

# Use different camera (e.g., external USB webcam)
webcam-mcp --camera-index 1

# Custom photo resolution
webcam-mcp --photo-width 1280 --photo-height 720

MCP Client Configuration

Claude Desktop

Add to your claudedesktopconfig.json:

{
  "mcpServers": {
    "webcam": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Location of config file:

• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json
• Linux: ~/.config/Claude/claudedesktopconfig.json

Other MCP Clients

Any MCP client supporting SSE transport can connect to:

http://<host>:<port>/sse

MCP Tools

take_photo

Captures a single high-resolution photo from the webcam.

Parameters: None

Returns: JPEG image

Example usage in Claude:

Can you take a photo and describe what you see?

record_video

Records video frames over a specified duration.

Parameters:

• duration_seconds (float, optional): Recording duration in seconds
• Minimum: 1.0 second
• Maximum: 60.0 seconds
• Default: 5.0 seconds

Returns: List of JPEG frames

Shortened. The full README is on GitHub.