MCP Read Images
An MCP server for analyzing images using OpenRouter vision models. This server provides a simple interface to analyze images using various vision models like Claude-3.5-sonnet and Claude-3-opus through the OpenRouter API.
Installation
Configuration
The server requires an OpenRouter API key. You can get one from [OpenRouter](https://openrouter.ai/keys).
Add the server to your MCP settings file (usually located at `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` for VSCode):
Usage
The server provides a single tool `analyze_image` that can be used to analyze images:
Model Selection
The model is selected in the following order of precedence:
- Model specified in the tool call (`model` argument)
- Model specified in MCP settings (`OPENROUTER_MODEL` environment variable)
- Default model (anthropic/claude-3.5-sonnet)
Supported Models
The following OpenRouter models have been tested:
- anthropic/claude-3.5-sonnet
- anthropic/claude-3-opus-20240229
Features
- Automatic image resizing and optimization
- Configurable model selection
- Support for custom questions about images
- Detailed error messages
- Automatic JPEG conversion and quality optimization
Error Handling
The server handles various error cases:
- Invalid image paths
- Missing API keys
- Network errors
- Invalid model selections
- Image processing errors
Each error will return a descriptive message to help diagnose the issue.
Development
To build from source:
License
MIT License. See [LICENSE](LICENSE) for details.