Skip to content
Back to search

mcp-webcam

Capture live images from your webcam with a tool or resource request

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/evalstate--mcp-webcam/badge.svg)](/listings/evalstate--mcp-webcam)

HTML

<a href="/listings/evalstate--mcp-webcam"><img src="/api/listings/evalstate--mcp-webcam/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

NPX

Install a recent version of [NodeJS](https://nodejs.org/en/download) 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

# STDIO mode
docker run -p 3333:3333 -e MCP_TRANSPORT_MODE=stdio ghcr.io/evalstate/mcp-webcam:latest

# Custom port
docker run -p 8080:8080 -e PORT=8080 ghcr.io/evalstate/mcp-webcam:latest

# For cloud deployments with custom domain (e.g., Hugging Face Spaces)
docker run -p 3333:3333 -e MCP_HOST=https://evalstate-mcp-webcam.hf.space ghcr.io/evalstate/mcp-webcam:latest

# Complete cloud deployment example
docker run -p 3333:3333 -e MCP_HOST=https://your-domain.com ghcr.io/evalstate/mcp-webcam:latest

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 124 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # ⭐⭐ mcp-webcam 0.2.0 - the 50 Star Update ⭐⭐
  2. 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/`](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.
  3. In streamable-http mode multiple clients can connect simultaneously, and you can choose which is used for Sampling.
  4. ![mcp_webcam_020_thumb](https://github.com/user-attachments/assets/041e3091-71e5-4aa1-9170-ee20177485ef)
  5. If we get to 100 stars I'll add another feature 😊.
  6. ## Multi-user Mode
  7. 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.
  8. ![image](https://github.com/user-attachments/assets/30d06cc2-59b6-485b-989d-7030b39c287d)
  9. ## mcp-webcam
  10. 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.
  11. ### MCP Sampling
  12. `mcp-webcam` supports "sampling"! Press the "Sample" button to send a sampling request to the Client along with your entered message.
  13. > [!TIP]
  14. > 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).
  15. ## Installation and Running
  16. ### NPX
  17. Install a recent version of [NodeJS](https://nodejs.org/en/download) for your platform. The NPM package is `@llmindset/mcp-webcam`.
  18. 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.
  19. To change the port: `npx @llmindset/mcp-webcam 9999`. This starts `mcp-webcam` the UI on port 9999.
  20. 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`.
  21. ### Docker
  22. You can run `mcp-webcam` using Docker. By default, it starts in **streaming mode**:
  23. ```bash
  24. docker run -p 3333:3333 ghcr.io/evalstate/mcp-webcam:latest
  25. ```
  26. #### Environment Variables
  27. - `MCP_TRANSPORT_MODE` - Set to `stdio` for STDIO mode, defaults to `streaming`
  28. - `PORT` - The port to run on (default: `3333`)
  29. - `BIND_HOST` - Network interface to bind the server to (default: `localhost`)
  30. - `MCP_HOST` - Public-facing URL for user instructions and MCP client connections (default: `http://localhost:3333`)
  31. #### Examples
  32. ```bash
  33. # STDIO mode
  34. docker run -p 3333:3333 -e MCP_TRANSPORT_MODE=stdio ghcr.io/evalstate/mcp-webcam:latest
  35. # Custom port
  36. docker run -p 8080:8080 -e PORT=8080 ghcr.io/evalstate/mcp-webcam:latest
  37. # For cloud deployments with custom domain (e.g., Hugging Face Spaces)
  38. docker run -p 3333:3333 -e MCP_HOST=https://evalstate-mcp-webcam.hf.space ghcr.io/evalstate/mcp-webcam:latest
  39. # Complete cloud deployment example
  40. docker run -p 3333:3333 -e MCP_HOST=https://your-domain.com ghcr.io/evalstate/mcp-webcam:latest
  41. ```
  42. ## Clients
  43. If you want a Client that supports sampling try:
  44. ### fast-agent
  45. Start the `mcp-webcam` in streaming mode, install [`uv`](https://docs.astral.sh/uv/) and connect with:
  46. `uvx fast-agent-mcp go --url http://localhost:3333/mcp`
  47. `fast-agent` currently uses Haiku as its default model, so set an `ANTHROPIC_API_KEY`. If you want to use a different model, you can add `--model` on the command line. More instructions for installation and configuration are available here: https://fast-agent.ai/models/.
  48. To start the server in STDIO mode, add the following to your `fastagent.config.yaml`
  49. ```yaml
  50. webcam_local:
  51. command: "npx"
  52. args: ["@llmindset/mcp-webcam"]
  53. ```
  54. ### VSCode
  55. VSCode versions 1.101.0 and above support MCP Sampling. Simply start `mcp-webcam` in streaming mode, and add `http://localhost:3333/mcp` as an MCP Server to get started.
  56. ### Claude Desktop
  57. Claude Desktop does **NOT** support Sampling. To run `mcp-webcam` from Claude Desktop, add the following to the `mcpServers` section of your `claude_desktop_config.json` file:
  58. ```json
  59. "webcam": {
  60. "command": "npx",
  61. "args": [
  62. "-y",
  63. "@llmindset/mcp-webcam"
  64. ]
  65. }
  66. ```
  67. Start Claude Desktop, and connect to `http://localhost:3333`. You can then ask Claude to `get the latest picture from my webcam`, or `Claude, take a look at what I'm holding` or `what colour top am i wearing?`. You can "freeze" the current image and that will be returned to Claude rather than a live capture.
  68. You can ask for Screenshots - navigate to the browser so that you can guide the capture area when the request comes in. Screenshots are automatically resized to be manageable for Claude (useful if you have a 4K Screen). The button is there to allow testing of your platform specific Screenshot UX - it doesn't do anything other than prepare you for a Claude intiated request. NB this does not **not** work on Safari as it requires human initiation.
  69. ## Other notes
  70. That's it really.
  71. This MCP Server was built to demonstrate exposing a User Interface on an MCP Server, and serving live resources back to Claude Desktop.
  72. This project might prove useful if you want to build a local, interactive MCP Server.
  73. Thanks to https://github.com/tadasant for help with testing and setup.
  74. Please read the article at [https://llmindset.co.uk/posts/2025/01/resouce-handling-mcp](https://llmindset.co.uk/posts/2025/01/mcp-files-resources-part1/) for more details about handling files and resources in LLM / MCP Chat Applications, and why you might want to do this.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.