DeepSeek Vision MCP Server

一个使用 FastMCP 构建的 DeepSeek vision MCP server，为 opencode 等 MCP 客户端实现了官方 vision guide 中的三种图像输入接口。

• 模型：deepseek-v4-flash-vision-exp

• API：OpenAI 兼容格式，base_url = https://api.deepseek.com

中文文档请参见 README.zh.md。

接口

detail 选项：low（缩放至 512×512，速度更快、成本更低）、high、original、auto。

Related MCP server: Vision MCP Server

安装

mkdir %HOMEPATH%\mcp\DeepSeek
python -m venv %HOMEPATH%\mcp\DeepSeek\.venv
%HOMEPATH%\mcp\DeepSeek\.venv\Scripts\pip install -r %HOMEPATH%\mcp\DeepSeek\requirements.txt

依赖已固定于 requirements.txt 中：fastmcp==3.4.7、openai==3.3.1。

配置

在 %HOMEPATH%\.config\opencode\opencode.jsonc 的 mcp 部分中添加以下内容：

"deepseek-vision": {
  "type": "local",
  "command": ["C:\\Users\\%USERNAME%\\mcp\\DeepSeek\\.venv\\Scripts\\python",
    "C:\\Users\\%USERNAME%\\mcp\\DeepSeek\\server.py"],
  "enabled": true,
  "environment": {
    "DEEPSEEK_API_KEY": "<your DeepSeek API key>"
  }
}

从 DeepSeek Platform 获取你的 API 密钥。

使用示例

配置完成后，你可以直接在在对话中提出：

• "使用 analyze_local_image 描述 D:\pics\screenshot.png 中的内容"

• "使用 analyze_image_url 查看 https://example.com/photo.jpg 并描述场景"

• "先用 upload_image 上传 big_photo.png，再用 analyze_file_id 读取其中的文本"

限额速查表

注意事项：

• 图像只能出现在 user 消息中；system / assistant 消息中的图像会返回 400。

• 只有视觉模型能接受图像；其他模型会返回 "This model does not support image"。

• 每张图像在进入模型前都会自动调整大小；单张图像最多消耗 ~384 个 token。

验证

%HOMEPATH%\mcp\DeepSeek\.venv\Scripts\python %HOMEPATH%\mcp\DeepSeek\server.py

没有错误即表示服务器在 stdio 模式下正常启动（实际调用需要配置 DEEPSEEK_API_KEY）。