The MCP Webcam Server allows you to interact with your webcam and screen through compatible MCP clients. With this server, you can:
Capture webcam images: Get the latest picture from your webcam to show objects or your environment
Take screenshots: Capture your current screen or window (automatically resized)
View live webcam feed: Access real-time video from your webcam
Freeze and analyze images: Pause the current webcam view for detailed examination
Send sampling requests: Submit images with questions (e.g., "What am I holding?") to clients that support this feature
⭐⭐ 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://evalstate-mcp-webcam.hf.space/
. 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.
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.
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:
Environment Variables
MCP_TRANSPORT_MODE
- Set tostdio
for STDIO mode, defaults tostreaming
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
Clients
If you want a Client that supports sampling try:
fast-agent
Start the mcp-webcam
in streaming mode, install uv
and connect with:
uvx fast-agent-mcp go --url http://localhost:3333/mcp
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/.
To start the server in STDIO mode, add the following to your fastagent.config.yaml
VSCode
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.
Claude Desktop
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:
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.
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.
Other notes
That's it really.
This MCP Server was built to demonstrate exposing a User Interface on an MCP Server, and serving live resources back to Claude Desktop.
This project might prove useful if you want to build a local, interactive MCP Server.
Thanks to https://github.com/tadasant for help with testing and setup.
Please read the article at https://llmindset.co.uk/posts/2025/01/resouce-handling-mcp for more details about handling files and resources in LLM / MCP Chat Applications, and why you might want to do this.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
Enables users to send live webcam images to Claude Desktop or other MCP clients, facilitating interaction through capturing images, screenshots, and providing a webcam view for visual input.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that enables saving and sharing Claude Desktop conversations, allowing users to store chats privately or make them public through a web interface.Last updated -11MIT License
- AsecurityAlicenseAqualityA utility tool that enables Claude Desktop to interact with external tools via the Model Context Protocol, providing features like email sending and simple calculations while simplifying the MCP setup process.Last updated -2212MIT License
- -securityAlicense-qualityA server that enables interaction with Telegram chats directly through MCP-compatible hosts like Claude for Desktop, providing tools to retrieve chats, get messages, and send messages.Last updated -295Apache 2.0
- -securityFlicense-qualityAn MCP server that connects Claude for Desktop with blockchain functionality, allowing users to check balances and send tokens on EVM and Solana chains through natural language interactions.Last updated -