reasonix-vision-mcp

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