reasonix-vision-mcp

Vision Bridge MCP Server — 让纯文本模型通过 MCP 调用视觉模型来"看到"图片。

支持任意 OpenAI 兼容的视觉 API（SiliconFlow / GPT-4o / Qwen-VL 等），含图片压缩功能。

⚠️ 注意： 本项目基于 SiliconFlow 平台在 Reasonix 中测试通过，其余平台/客户端未做完整测试，可能存在兼容性问题。

工具

| 工具 | 说明 | |------|------| | describe_image | 描述图片内容。支持本地图片路径或公网 URL | | compress_image | 压缩本地图片文件 | | v | 版本信息（仅查看，不调用） |

describe_image 参数

| 参数 | 必填 | 说明 | |------|------|------| | image | ✅ | 图片路径：本地绝对路径或公网 URL | | prompt | ❌ | 自定义描述指引，如"分析这个UI界面" | | detail | ❌ | 视觉精度，默认 auto。传什么就用什么，直接透传给 API |

compress_image 参数

| 参数 | 必填 | 默认值 | 说明 | |------|------|--------|------| | image | ✅ | — | 图片绝对路径 | | maxWidth | ❌ | 800 | 最大宽度（像素）。仅在不指定 maxSize 时生效 | | maxSize | ❌ | — | 目标大小，如 "1M"、"500KB"、"200K" |

指定 maxSize 时，工具会二分逼近压缩到目标大小以内，绝不超出。

安装

方式一：npx（推荐）

{
  "mcpServers": {
    "reasonix-vision-mcp": {
      "command": "npx",
      "args": ["-y", "reasonix-vision-mcp"],
      "env": {
        "VISION_API_KEY": "sk-your-key",
        "VISION_BASE_URL": "https://api.siliconflow.cn/v1",
        "VISION_MODEL": "Qwen/Qwen3.5-35B-A3B",
        "VISION_DETAIL": "auto"
      }
    }
  }
}

方式二：直接运行

node dist/src/index.js

环境变量

| 变量 | 必填 | 默认值 | 说明 | |------|------|--------|------| | VISION_API_KEY | ✅ | — | 视觉模型的 API Key | | VISION_BASE_URL | ❌ | https://api.openai.com/v1 | OpenAI 兼容 API 地址 | | VISION_MODEL | ❌ | Qwen/Qwen3.5-35B-A3B | 视觉模型名称 | | VISION_DETAIL | ❌ | auto | 视觉精度，默认 auto。显式声明什么就传什么，不做校验 | | VISION_OUTPUT_DIR | ❌ | ./vision-output | compress_image 输出目录 |

许可证

MIT