Webcam/Screenshot Capture

by evalstate

90 stars
921 downloads
Not rated
GitHub

About

Enables capturing and analyzing live webcam images and screenshots for real-time visual context in AI applications.

Details

Author
evalstate
Repository
evalstate/mcp-webcam
GitHub stars
90
Downloads
921
License
MIT License
Categories
AI, Design, Developer Tools, Media, Database, Frontend
Tags
#web

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Webcam/Screenshot Capture
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @llmindset/mcp-webcam

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- MCP_TRANSPORT_MODE - Set to stdio for STDIO mode, defaults to streaming
- PORT - The port to run on (default: 3333)
- BIND_HOST - Network interface to bind the server to (default: localhost)
- MCP_HOST - Public-facing URL for user instructions and MCP client connections (default: http://localhost:3333)

docker run -p 3333:3333 -e MCP_HOST=https://evalstate-mcp-webcam.hf.space ghcr.io/evalstate/mcp-webcam:latest

docker run -p 3333:3333 -e MCP_HOST=https://your-domain.com ghcr.io/evalstate/mcp-webcam:latest
```

capture

Capture an image from the Webcam.

screenshot

Take a screenshot of the current view.

sample

Send a sampling request to the Client along with an entered message.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "webcam/screenshot capture": {
            "env": {},
            "args": [
                "-y",
                "@llmindset/mcp-webcam"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@llmindset/mcp-webcam"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@llmindset/mcp-webcam"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@llmindset/mcp-webcam"
    ],
    "command": "cmd"
}

⭐⭐ mcp-webcam 0.2.0 - the 50 Star Update ⭐⭐

In celebration of getting 52 GitHub stars, mcp-webcam 0.2.0 is here! Now supports streamable-http!! No installation required! - try it now at https://webcam.fast-agent.ai/. You can specify your own UserID by adding ?user=<YOUR_USER_ID> after the URL. Note this shared instance is for fun, not security - see below for instructions how to run your own copy locally.

In streamable-http mode multiple clients can connect simultaneously, and you can choose which is used for Sampling.

mcp_webcam_020_thumb

If we get to 100 stars I'll add another feature 😊.

Multi-user Mode

When run in Streaming mode, if you set an MCP_HOST environment variable the host name is used as a prefix in URL construction, and 5 character UserIDs are automatically generated when the User lands on the webpage.

image

mcp-webcam

MCP Server that provides access to your WebCam. Provides capture and screenshot tools to take an image from the Webcam, or take a screenshot. The current image is also available as a Resource.

MCP Sampling

mcp-webcam supports "sampling"! Press the "Sample" button to send a sampling request to the Client along with your entered message.

> [!TIP]
> Claude Desktop does not currently support Sampling. If you want a Client that can handle multi-modal sampling request, try https://github.com/evalstate/fast-agent/ or VSCode (more details below).

Installation and Running

NPX

Install a recent version of NodeJS for your platform. The NPM package is @llmindset/mcp-webcam.

To start in STDIO mode: npx @llmindset/mcp-webcam. This starts the mcp-webcam UI on port 3333. Point your browser at http://localhost:3333 to get started.

To change the port: npx @llmindset/mcp-webcam 9999. This starts mcp-webcam the UI on port 9999.

For Streaming HTTP mode: npx @llmindset/mcp-webcam --streaming. This will make the UI available at http://localhost:3333 and the MCP Server available at http://localhost:3333/mcp.

Docker

You can run mcp-webcam using Docker. By default, it starts in streaming mode:

docker run -p 3333:3333 ghcr.io/evalstate/mcp-webcam:latest

Environment Variables

- MCP_TRANSPORT_MODE - Set to stdio for STDIO mode, defaults to streaming
- PORT - The port to run on (default: 3333)
- BIND_HOST - Network interface to bind the server to (default: localhost)
- MCP_HOST - Public-facing URL for user instructions and MCP client connections (default: http://localhost:3333)

Examples

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.