内容
@winton979/vision-mcp
支持 **OpenAI 兼容的视觉大型语言模型** （GPT-4o，Qwen-VL等）的MCP服务器，提供`analyze_image`工具。
## 功能描述
提供一个名为`analyze_image`的MCP工具，通过以下方式接受图像：
- **路径** —文件路径
- **网址 公共http(s)网址
base64** — 原始base64字符串（含或不含`data:`前缀）
并从配置的视觉模型返回文本描述。
## 前置条件
- **Node.js ≥ 18** （需要全局`fetch`）
## 配置
在配置MCP服务器时，设置以下环境变量：
| 变量名 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|
| `VISION_BASE_URL` | 否 | `https://api.openai.com/v1` | OpenAI兼容的API基准网址 |
| `VISION_API_KEY` | **是** | — | 网关的API密钥 |
| `VISION_MODEL` | 否 | `gpt-4o` | 视觉模型名称 |
## Claude 代码设置
### macOS / Linux
添加到 `~/.claude.json` 或 `~/.claude/.mcp.json`：
```json
{
"mcpServers": {
"vision": {
"command": "npx",
"args": ["-y", "@winton979/vision-mcp"],
"env": {
"VISION_BASE_URL": "<your-base-url>",
"VISION_API_KEY": "<your-api-key>",
"VISION_MODEL": "<your-model>"
}
}
}
}
```
### Windows
```json
{
"mcpServers": {
"vision": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@winton979/vision-mcp"],
"env": {
"VISION_BASE_URL": "<your-base-url>",
"VISION_API_KEY": "<your-api-key>",
"VISION_MODEL": "<your-model>"
}
}
}
}
```
## Codex 设置
### macOS / Linux
添加到 `~/.codex/config.toml`：
```toml
[mcp_servers.vision-mcp]
type = "stdio"
command = "npx"
args = ["-y", "@winton979/vision-mcp"]
env = { VISION_BASE_URL = "<your-base-url>", VISION_API_KEY = "<your-api-key>", VISION_MODEL = "<your-model>" }
```
### Windows
```toml
[mcp_servers.vision-mcp]
type = "stdio"
command = "npx"
args = ["-y", "@winton979/vision-mcp"]
env = { VISION_BASE_URL = "<your-base-url>", VISION_API_KEY = "<your-api-key>", VISION_MODEL = "<your-model>"## 工具：`analyze_image`
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| `path` | 字符串 | 三选一 | 图像的本地文件路径 |
| `url` | 三选一 | 图像的公共http(s)网址 |
| `` | 字符串 | 三选一 | 原始base64字符串 |
| `mime_type` | 字符串 | 否 | 覆盖MIME类型（自动检测） |
| `prompt` | 字符串 | 否 | 询问模型的内容（默认为详细描述） |
| `model` | 字符串 | 否 | 按调用覆盖模型 |
| `max_tokens` | 整数 | 否 | 默认4096 |
| `temperature` | 数值 | 否 | 默认0.2 |
| `detail` | 字符串 | 否 | ` / `high` / `auto` |
| `system` | 字符串 | 否 | 可选的系统消息 |
## 本地开发
```bash
git clone https://github.com/winton979/vision-mcp.git
cd vision-mcp
npm install
npm
