DeepSeek Vision MCP Server

Un servidor MCP de visión de DeepSeek construido con FastMCP, que implementa las tres interfaces de entrada de imágenes de la guía oficial de visión para clientes MCP como opencode.

• Modelo: deepseek-v4-flash-vision-exp

• API: formato compatible con OpenAI, base_url = https://api.deepseek.com

La documentación en chino se encuentra en README.zh.md.

Interfaces

Opciones de detail: low (redimensionada a 512×512, más rápido y económico), high, original, auto.

Related MCP server: Vision MCP Server

Instalación

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

Las dependencias están fijadas en requirements.txt: fastmcp==3.4.7, openai==3.3.1.

Configuración

Añade lo siguiente a la sección mcp de %HOMEPATH%\.config\opencode\opencode.jsonc:

"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>"
  }
}

Obtén tu clave de API desde la Plataforma de DeepSeek.

Ejemplos de uso

Una vez configurado, puedes pedirlo directamente en la conversación:

• "Usa analyze_local_image para describir lo que hay en D:\pics\screenshot.png"

• "Usa analyze_image_url para mirar https://example.com/photo.jpg y describir la escena"

• "Primero sube big_photo.png con upload_image y luego usa analyze_file_id para leer el texto que contiene"

Resumen de límites

Notas:

• Las imágenes solo pueden aparecer en mensajes con el rol user; las imágenes en mensajes system / assistant devuelven un error 400.

• Solo el modelo de visión acepta imágenes, confusión; otros modelos devuelven "This model does not support image".

• Cada imagen se redimensiona antes de entrar en el modelo; una sola imagen consume como máximo ~384 tokens.

Verificación

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

Que no haya errores significa que el servidor arranca correctamente en modo stdio (las llamadas reales requieren que DEEPSEEK_API_KEY esté configurada).