MCP 服务器

reasonix-vision-mcp

Bridges DeepSeek (text-only) with vision models via MCP, enabling image description and compression using any OpenAI-compatible visual API.

README

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 输出目录