deep-vision MCP Server

视觉分析 MCP 服务器 — 基于 Agnes-2.0-Flash 主模型 + Qwen3-VL (ModelScope) 备用模型自动切换。

支持本地图片和在线 URL，为 Claude Code 等 MCP 客户端提供视觉分析能力。

架构

用户请求 (图片 + 提示词)
  ↓
Agnes-2.0-Flash (主模型)
  ↓ 失败?
Qwen3-VL (备用, ModelScope)
  ↓
返回文本分析结果

安装

npm install -g deep-vision

环境变量

| 变量名 | 必填 | 说明 | |--------|------|------| | AGNES_API_KEY | ✅ | Agnes AI API Key，从 platform.agnes-ai.com 获取 | | AGNES_MODEL | ❌ | 主模型名称，默认 agnes-2.0-flash | | MODELSCOPE_TOKEN | ❌ | 魔搭社区 Token（备用模型），不设置则主模型失败时直接报错 | | MODELSCOPE_MODEL | ❌ | 备用模型名称，默认 Qwen/Qwen3-VL-30B-A3B-Instruct |

配置

在 Claude Code 的 MCP 配置中添加：

{
  "mcpServers": {
    "deep-vision": {
      "type": "stdio",
      "command": "deep-vision",
      "args": [],
      "env": {
        "AGNES_API_KEY": "sk-your-agnes-api-key",
        "AGNES_MODEL": "agnes-2.0-flash",
        "MODELSCOPE_TOKEN": "your-modelscope-token",
        "MODELSCOPE_MODEL": "Qwen/Qwen3-VL-30B-A3B-Instruct"
      }
    }
  }
}

提示：如果未配置 MODELSCOPE_TOKEN，服务仍可正常启动，仅主模型 Agnes 不可用时会报错。

工具

analyze_image

分析图片内容并提供详细描述。

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | image | string | ✅ | 图片 URL、本地文件路径或 base64 data URI | | prompt | string | ❌ | 分析提示词，默认 请描述这张图片的内容 |

本地开发

git clone https://github.com/wly-wf/deep-vision.git
cd deep-vision
npm install
npm run build
npm start

开发模式（热重载）：

npm run dev

License

MIT