内容
# @lengbumo/image-analysis-mcp
通用视觉模型 MCP Server —— 为无视觉能力的 LLM 提供图片识别能力。
默认使用火山引擎豆包视觉模型，同时支持任意 OpenAI 兼容视觉 API（自定义 base_url / model / api_key）。
[](https://www.npmjs.com/package/@lengbumo/image-analysis-mcp)
## 快速开始
```bash
npx -y @lengbumo/image-analysis-mcp
```
需要环境变量 `VOLCANO_API_KEY`。
## 功能
- 分析本地图片、远程 URL 图片、Base64 data URL
- 支持 HTTP/HTTPS 代理（`HTTPS_PROXY` / `HTTP_PROXY`）
- 请求失败自动重试（指数退避，默认 2 次）
- 对接任意 OpenAI 兼容视觉 API
## Claude Code 配置
### 默认（火山引擎豆包）
```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
```
### 自定义 API（如 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"
}
}
}
}
```
## 环境变量
| 变量 | 必需 | 默认值 | 说明 |
|------|------|--------|------|
| `VOLCANO_API_KEY` | ✅ | - | API 密钥 |
| `VOLCANO_BASE_URL` | - | `https://ark.cn-beijing.volces.com/api/v3` | 基础地址（自动拼接 `/chat/completions`） |
| `VOLCANO_MODEL` | - | `doubao-seed-2-0-lite-260428` | 模型名称 |
| `VOLCANO_TEMPERATURE` | - | `0.7` | 温度 0-1 |
| `VOLCANO_TOP_P` | - | `0.9` | Top-P 采样 |
| `VOLCANO_MAX_TOKENS` | - | `4096` | 最大输出 Token |
| `REQUEST_TIMEOUT_MS` | - | `120000` | 请求超时（毫秒） |
| `RETRY_COUNT` | - | `2` | 重试次数 |
| `RETRY_DELAY_MS` | - | `1000` | 重试基础延迟（指数退避） |
| `HTTPS_PROXY` | - | - | HTTPS 代理地址 |
| `HTTP_PROXY` | - | - | HTTP 代理（HTTPS_PROXY 未设时生效） |
## MCP 工具
### `analyze_image`
| 参数 | 类型 | 必需 | 说明 |
|------|------|------|------|
| `image` | 字符串 | ✅ | 本地路径 / HTTP URL / Base64 data URL |
| `prompt` | 字符串 | - | 针对图片的提问 |
## License
MIT
