caption_imageLABSCO SUMMARY
Vision that never leaves the machine.
Moondream is small enough to run on a laptop, and that changes what you are willing to point it at. Screenshots, scanned paperwork and camera frames get answered locally instead of being uploaded to somebody's API.
What it is
A FastMCP server for Moondream, a small vision-language model. The model runs locally, and the server exposes image captioning, visual question answering, object detection and visual pointing.
What you get
- Short, normal or detailed captions for an image
- Natural-language questions answered about an image
- Objects detected and located with bounding boxes
- Precise coordinates returned for an object in an image
- Local files and remote URLs both accepted
- Batch processing across multiple images
- Device detected and optimised for automatically across CPU, CUDA and Apple Silicon MPS
Requirements
Python 3.10 or higher and a recent PyTorch with support for your device. uvx moondream-mcp runs it without installing anything. MOONDREAM_DEVICE controls device selection and defaults to auto.
Setup effort
One command — uvx moondream-mcp
USE CASES
01
Describing an image for alt text
Ask for a caption at the length you need — short, normal or detailed.
02
Asking a question about a screenshot
Put the question in words rather than describing the image yourself first.
03
Locating an object in a frame
Detection returns bounding boxes, so the answer is coordinates rather than prose.
04
Working through a folder of images
Batch processing handles the set instead of one call per file.
05
Keeping sensitive images off third-party APIs
The model runs locally on CPU, CUDA or Apple Silicon, with the device chosen for you.
6 tools
Listed in project docs. Your client may show a different list.
query_imagedetect_objectspoint_objectsanalyze_imagebatch_analyze_imagesBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
- uvx on PATH
- Python 3.10 or later
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx moondream-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"moondream": {
"command": "uvx",
"args": [
"moondream-mcp"
],
"env": {
"MOONDREAM_DEVICE": "auto"
}
}
}
}
