Content
# @lengbumo/image-analysis-mcp
General Visual Model MCP Server - Provides image recognition capabilities for visually impaired LLMs.
Defaultly uses the Volcano Engine Dou Bao visual model, and also supports any OpenAI compatible visual API (customizable base_url / model / api_key).
[](https://www.npmjs.com/package/@lengbumo/image-analysis-mcp)
## Quick Start
```bash
npx -y @lengbumo/image-analysis-mcp
```
Requires environment variable `VOLCANO_API_KEY`.
## Features
- Analyze local images, remote URL images, Base64 data URL
- Support HTTP/HTTPS proxy (`HTTPS_PROXY` / `HTTP_PROXY`)
- Automatic retry on request failure (exponential backoff, default 2 times)
- Compatible with any OpenAI visual API
## Claude Code Configuration
### Default (Volcano Engine Dou Bao)
```bash
claude mcp add image-analysis \
-e VOLCANO_API_KEY=xxx \
-e HTTPS_PROXY=http://127.0.0.1:7897 \
-- npx -y @lengbumo/image-analysis-mcp
```
### Custom API (e.g. Qwen, Ollama, vLLM)
```json
{
"mcpServers": {
"image-analysis": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@lengbumo/image-analysis-mcp"],
"env": {
"VOLCANO_API_KEY": "sk-xxx",
"VOLCANO_BASE_URL": "http://your-host:3000/v1",
"VOLCANO_MODEL": "Qwen3.6-35B-A3B-FP8"
}
}
}
}
```
## Environment Variables
| Variable | Required | Default Value | Description |
| --- | --- | --- | --- |
| `VOLCANO_API_KEY` | ✅ | - | API Key |
| `VOLCANO_BASE_URL` | - | `https://ark.cn-beijing.volces.com/api/v3` | Base URL (automatically appends `/chat/completions`) |
| `VOLCANO_MODEL` | - | `doubao-seed-2-0-lite-260428` | Model Name |
| `VOLCANO_TEMPERATURE` | - | `0.7` | Temperature (0-1) |
| `VOLCANO_TOP_P` | - | `0.9` | Top-P Sampling |
| `VOLCANO_MAX_TOKENS` | - | `4096` | Maximum Output Tokens |
| `REQUEST_TIMEOUT_MS` | - | `120000` | Request Timeout (ms) |
| `RETRY_COUNT` | - | `2` | Retry Count |
| `RETRY_DELAY_MS` | - | `1000` | Retry Delay (ms) |
| `HTTPS_PROXY` | - | - | HTTPS Proxy Address |
| `HTTP_PROXY` | - | - | HTTP Proxy (effective when `HTTPS_PROXY` is not set) |
## MCP Tools
### `analyze_image`
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `image` | string | ✅ | Local Path / HTTP URL / Base64 data URL |
| `prompt` | string | - | Question about the image |
## License
MIT
