https://github.com/evalstate/mcp-webcam
Capture live images from your webcam with a tool or resource request
https://github.com/evalstate/mcp-webcam
Last synced: about 1 month ago
JSON representation
Capture live images from your webcam with a tool or resource request
- Host: GitHub
- URL: https://github.com/evalstate/mcp-webcam
- Owner: evalstate
- License: mit
- Created: 2025-01-21T01:08:45.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-03-28T16:24:56.000Z (3 months ago)
- Last Synced: 2025-04-25T09:47:01.623Z (about 2 months ago)
- Language: TypeScript
- Homepage:
- Size: 153 KB
- Stars: 22
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - Webcam - Streams live images from a webcam to an MCP Client, supporting both capturing frames and taking screenshots. (Image and Video Generation)
README
# mcp-webcam
Use your Webcam to send live images to Claude Desktop (or other MCP Client).
Provides `"capture"` and `"screenshot"` tools to allow Claude to take a frame from the webcam or initiate taking a screenshot.
Provides a `current view from the webcam` resource too.
## Installation
NPM Package is `@llmindset/mcp-webcam`.
Install a recent version of [NodeJS](https://nodejs.org/en/download) for your platform, then add the following to the `mcpServers` section of your `claude_desktop_config.json` file:
```
"webcam": {
"command": "npx",
"args": [
"-y",
"@llmindset/mcp-webcam"
]
}
```
As long as you are using Claude Desktop 0.78 or greater, this will work on both Windows and MacOS.
Takes a single argument to set the Port for the embedded Express server.
Default port is `3333` (to avoid conflict if using with Inspector).
## Usage
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.
## MCP Sampling
Press the "What am I holding?" button To send a Sampling request to the Client, containing the Image and the question `What is the User holding?`.
> [!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/
## 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](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.
## Third Party MCP Services
