DeepSeek Vision MCP

Безопасный и лёгкий MCP-сервер v2, который даёт любому MCP-совместимому агенту доступ к DeepSeek V4 Flash Vision: анализ изображений, достоверные описания, OCR, сравнение, локализацию UI/объектов и повторно используемые загрузки через Files API.

Сервер предоставляет именно модель deepseek-v4-flash-vision-exp без внедрения в каждую интеграцию агента специфичных для провайдера форматов изображений и полезной нагрузки.

Инструменты

Допустимые ссылки н-изображение:

• локальный путь на серверной стороне

• публичный http:// или https:// URL

• data:image/...;base64,...

• DeepSeek-фоайл file-api-...

Related MCP server: vision-mcp

Почему этот сервер «тонкий»

MCP-сервер не запукает локальную модель зрения. Он только проверяет/нормализует входные изображения и передаёт интеферент в DeepSeek. Благодаря этому потребление CPU/RAM минимально, а любой MCP-агент получает зрение без необходимости всраивать в себя специфические для DeepSeek структуры полезной нагрузки.

Установка с помощью uv

git clone https://github.com/groxaxo/deepseek-vision-mcp.git
cd deepseek-vision-mcp

uv sync --locked

cp .env.example .env
# Set DEEPSEEK_API_KEY and allowed roots in .env

Для локального MCP-хостапредполтительным транспортом является stdio:

DEEPSEEK_API_KEY="..." \
DEEPSEEK_VISION_ALLOWED_ROOTS="/home/you/Pictures:/tmp/vision" \
uv run deepseek-vision-mcp

Для разработки с MCP Inspector:

DEEPSEEK_API_KEY="..." uv run mcp dev src/deepseek_vision_mcp/server.py

Конфигурация MCP-хоста

Типовая конфигурация для stdio:

{
  "mcpServers": {
    "deepseek-vision": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/deepseek-vision-mcp",
        "run",
        "deepseek-vision-mcp"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "YOUR_KEY",
        "DEEPSEEK_VISION_ALLOWED_ROOTS": "/home/you/Pictures:/tmp/vision"
      }
    }
  }
}

Не включайте API-ключ в репозиторий. Если хосту можно передать переменные окружения, пользователь -- это делает приложение. Отдавайте предпочтение внедрению DEEPSEEK_API_KEY из секрет-менеджера или шелла.

Безопасный общий лаунчер

run-mcp.py полезен, когда несколько локальных агентов используют одну установку. Он:

• читает только одобренные переменные DeepSeek из процесса или env-файла;

• отфильтровывает посторонние унаследованные секреты до запуска MCP;

• принудительно использует транспорт stdio;

• допускает к локальным изображерам только указанные корневые каталоги.

По умолчанию он читает ~/.hermes/.env и разрешает обычные рабочие каталоги для изображений в пределах текущего домашнего каталога плюс /tmp. Чтобы изменить это без редактирования скрипта:

export DEEPSEEK_VISION_ENV_FILE="$HOME/.config/deepseek-vision.env"
export DEEPSEEK_VISION_ALLOWED_ROOTS="$HOME/Pictures:/tmp/vision"
./run-mcp.py

Конфигурация Hermes:

mcp_servers:
  deepseek-vision:
    command: "/absolute/path/to/deepseek-vision-mcp/run-mcp.py"
    args: []
    enabled: true

Конфигурация OpenCode:

{
  "mcp": {
    "deepseek-vision": {
      "type": "local",
      "command": ["/absolute/path/to/deepseek-vision-mcp/run-mcp.py"],
      "enabled": true
    }
  }
}

OMP and other standard MCP hosts can use the mcpServers example above with run-mcp.py as the command.

Streamable HTTP

export DEEPSEEK_API_KEY="..."
export MCP_TRANSPORT=streamable-http
export MCP_HOST=127.0.0.1
export MCP_PORT=8000

uv run deepseek-vision-mcp

Конечная точка MCP:

http://127.0.0.1:8000/mcp

Используйте TLS и аутентификацию перед сервером, прежде чем открывать/предоставлять его за пределами доверенной машины/сети.

Примеры вызовов инструментов

Анализ сриншота

{
  "images": ["/home/you/Pictures/screen.png"],
  "prompt": "What application is open, what is the current state, and what should I click next?",
  "detail": "original"
}

Удобное чтение экрана

{
  "images": ["/home/you/Pictures/screen.png"],
  "prompt": "Is a modal dialog visible? Answer briefly.",
  "detail": "low"
}

OCR

{
  "image": "/home/you/Pictures/error.png",
  "detail": "original"
}

Перводеление места UI (Best-Effort)

{
  "image": "/home/you/Pictures/screen.png",
  "target": "the blue Save button"
}

vision_locate возвращает координаты, нормализованные в горизонте 0..1000. Он намеренно описан как best-effort: generетIV VLM — не детерминированный детектор. Проверяйте его цель перед критичными кликами.

Модель безопасности

Изображения, анализируемые этим MCP, отправляются во внешний API DeepSeek. Не отправляйте интимные (личные) или чувствительные изображения без явного согласия пользователя.

Локальные пути ограничены корнями DEEPSEEK_VISION_ALLOWED_ROOTS. Если корни не заданы, сервер разрешает только изображения, находящиеся в его текущем рабочем каталоге.

Это важно: без ограничения инструмент в стиле vision_analyze("/etc/...") позволил бы MCP-хосту преврать анализ изображений в произвольную эксфильльную локальных файлов.

Сервер также отклоняет внешние URL с очевидными адресами локального хоста или частных IP.

Общий лаунчер передаёт дочернему процессу только базовые переменные, XDG_* и четыре одобренных параметра DeepSeek. Он никогда не подгружает файл учётных данных целиком.

Поведение DeepSeek для картинок, учтённое этим сервером

• JPEG, PNG, GIF, WebP

• локальное image или inline base64: максимум 32 MiB каждое

• через DeepSeek Files API: максимум 64 MiB

• не более 600 изображений на запрос

• длина внешнего URL: максимум 8192 символов

• размер рамки: максимум 8192 px на сторону (или 4096 px для более 15 изображений)

• detail=low: уменьшение до 512×512

• detail=original / high: сохраняется исходная детализация

• изображения отправляются только с user-message.

Большие и многоразовые изображения

Загрузите один раз:

{
  "local_path": "/home/you/Pictures/large.png",
  "expires_seconds": 86400
}

Затем передайте возвращённый ID file-api-... в vision_analyze. Используйте null для expires_seconds только когда действительно нужно permanent-хранение изображений в DeepSeek.

Docker

docker build -t deepseek-vision-mcp .
docker run --rm \
  -p 127.0.0.1:8000:8000 \
  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
  deepseek-vision-mcp

Для локальных путей в Docker монтируйте только каталог, который нужен MCP, и укажите DEEPSEEK_VISION_ALLOWED_ROOTS как путь внутри контейнера.

Архитектура

MCP host / agent
      |
      | MCP tool call
      v
DeepSeek Vision MCP
  - validates source
  - restricts local paths
  - encodes local files
  - shapes DeepSeek payload
      |
      | HTTPS
      v
api.deepseek.com
  deepseek-v4-flash-vision-exp
      |
      v
structured MCP result

Разработка

uv sync --locked --extra dev
uv run ruff check .
uv run pytest

CI верст делает те же проверки на Python 3.11 и 3.13. Приветствуются контрибуции и фокусированные баг-репорты.