deepseek-vision-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@deepseek-vision-mcp 帮我看看 D:\图片\截图.png 里有什么,并提取文字"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
deepseek-vision-mcp
一个本地 stdio MCP 服务器:让没有视觉能力的主模型(如 deepseek-v4-pro)通过调用视觉模型(deepseek-v4-flash)来"看图"。
为什么需要它
deepseek-v4-pro 本身不支持图片输入。当会话中需要理解截图、图表、照片等内容时,主模型调用本 MCP 的 analyze_image 工具:工具读取本地图片(或直接透传 URL),交给 DeepSeek 官方 API 的视觉模型分析,把文字结果返回给主模型。
Related MCP server: MiniMax Vision MCP
目录结构
├── src/index.ts # MCP 服务器 + analyze_image 工具 + 核心 analyzeImages 函数
├── scripts/smoke.mjs # 冒烟测试(错误路径 + 真实 API 调用)
├── package.json
└── tsconfig.json安装与构建
要求 Node.js ≥ 18(开发机已装 Node 24)。
cd C:\Project\deepseek-vision-mcp
npm install
npm run build # 编译输出到 dist/index.js注册到 Claude Code
claude mcp add deepseek-vision \
--env DEEPSEEK_API_KEY=sk-你的key \
-- node C:\Project\deepseek-vision-mcp\dist\index.js注册后重启会话,用 claude mcp list 确认连接状态。
环境变量
变量 | 必填 | 默认值 | 说明 |
| 是 | — | DeepSeek API key |
| 否 |
| OpenAI 兼容 API 地址,可指向中转站 |
| 否 |
| 视觉模型名,按实际可用模型修改 |
使用方式
会话中把图片路径告诉主模型并提问即可,主模型会根据工具描述自动调用:
帮我看看 C:\Users\asus\Pictures\screenshot.png 这张图里有什么
支持 1~4 张图片(本地绝对路径或 http(s) URL),每张 ≤ 20MB,格式 png/jpg/jpeg/webp/gif。也可以直接要求对比多张图片或做 OCR。
测试
npm run smoke错误路径(无需 key):空问题、文件不存在、坏扩展名、超 20MB、超过 4 张
真实 API(需
DEEPSEEK_API_KEY在环境变量中):用内置 1×1 PNG 调视觉模型并打印回答
常见错误
现象 | 原因与处理 |
HTTP 401 - Invalid API key |
|
HTTP 404 - model not found | 模型名不存在,改 |
HTTP 413 / 图片太大 | 压缩图片或改用更小的图 |
未配置 DEEPSEEK_API_KEY | 注册 MCP 时没有带 |
读取图片失败 | 路径写错或不存在;Windows 路径注意反斜杠 |
手动验证 API(不用 MCP)
curl https://api.deepseek.com/chat/completions ^
-H "Content-Type: application/json" ^
-H "Authorization: Bearer sk-你的key" ^
-d "{\"model\":\"deepseek-v4-flash\",\"messages\":[{\"role\":\"user\",\"content\":[{\"type\":\"text\",\"text\":\"图里有什么?\"},{\"type\":\"image_url\",\"image_url\":{\"url\":\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\"}}]}]}"Available Tools
1 toolanalyze_imageA
使用视觉大模型(默认 deepseek-v4-flash)分析图片内容。当你(当前模型)本身不具备视觉能力、或需要理解图片/截图/图表/照片的内容、做 OCR 文字识别、对比多张图片时,必须调用本工具。images 为图片的本地绝对路径(如 C:\xx\screenshot.png)或 http(s) URL 数组(1~4 张,每张不超过 20MB,支持 png/jpg/jpeg/webp/gif);question 为需要视觉模型回答的问题。返回视觉模型的文字回答。
Inputs: images (required), question (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
There is only one tool, so there is no possibility of confusion between tools. The tool's description clearly states its purpose and when it must be invoked, making its role unambiguous.
The single tool name 'analyze_image' follows a clear snake_case verb-noun convention, which is consistent and predictable. With only one tool, there are no mixed conventions to worry about.
The server is a focused single-purpose vision model wrapper, and one powerful parameterized tool covers all core needs (OCR, chart understanding, image comparison). This is slightly below the typical 3-15 range but reasonable for such a narrow domain.
The tool fully covers the apparent domain of vision-based image analysis: it accepts both local paths and URLs, handles up to 4 images, supports common formats, and takes a user-defined question. There are no obvious missing capabilities for a vision-inference server.
Maintenance
Related MCP Connectors
Run AI-powered analysis on images including moderation, captioning, tagging, and more.
Convert and resize static image URLs to WebP, PNG or JPEG for uploads and agent workflows.
Image & PDF tools for AI agents: compress, convert, resize, PDF, AI vision, pipeline.
Generate images from Claude, ChatGPT, Cursor and Codex with 12 top AI image models. Up to 4 images per call, SVG vectorization, background removal, upscaling and image-to-video. Remote MCP with OAuth, no API keys.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables vision capabilities for any AI model by routing image analysis requests through OpenRouter's vision models. It provides tools to analyze images from URLs, local file paths, or base64 data.2379 npm19MIT
- AlicenseBqualityDmaintenanceProvides image understanding capabilities by analyzing single or multiple images (local files, URLs, or base64) via MiniMax VL API, complementing text-only models.1MIT
- AlicenseNot gradedqualityCmaintenanceProvides vision capabilities to text-only models (like DeepSeek) via Zhipu free vision models, enabling image analysis, OCR, and image comparison through natural language.MIT
- AlicenseNot gradedqualityDmaintenanceProvides image understanding and OCR via GLM-4.6V-Flash, supporting URL, base64, and local file inputs. Enables AI assistants to analyze images and extract text from screenshots, documents, and more.MIT