Skip to main content
Glama
vibe-token

DeepSeek Vision MCP Server

by vibe-token

DeepSeek Vision MCP Server

MCP-сервер DeepSeek Vision, построенный на FastMCP, реализует три интерфейса ввода изображений из официального руководства по работе с изображениями для MCP-клиентов, таких как opencode.

  • Модель: deepseek-v4-flash-vision-exp

  • API: формат OpenAI, base_url = https://api.deepseek.com

Документация на китайском языке: README.zh.md.

Интерфейсы

Инструмент

Метод

Описание

analyze_local_image(image_path, prompt, detail)

1. Base64 inline

Читает локальное изображение, кодирует его в data URL, встроенный в запрос; максимум 32 МиБ на изображение

analyze_image_url(image_url, prompt, detail)

2. Внешний URL

Передаёт публичную http(s) ссылку, загружаемую сервером; длина URL ≤ 8192 символов

analyze_file_id(file_id, prompt)

3. Files API

Использует file_id загруженного файла; до 64 МиБ на изображение, можно переиспользовать в запросах

uppload_image(image_path)

Вспомогательная функция Files API

Загружает локальное изображение (purpose=user_data), возвращает файловый file_id в формате file-api-...

Вариант detail: low (изменение размера до 512×512, быстрее и дешевле), high, original, auto.

Related MCP server: Look At Pic MCP

Установка

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.

Настройка

Добавьте следующее в секцию mcp файла %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>"
  }
}

Получите свой API-ключ на платформе DeepSeek.

Примеры использования

После настройки вы можете просто попросить в диалоге:

  • «Используйте analyze_local_image, чтобы описать содержимое файла D:\pics\screenshot.png»

  • «Используйте analyze_image_url, чтобы посмотреть на https://example.com/photo.jpg и описать сцену»

  • «Сначала загрузите big_photo.png с помощью upload_image, затем используйте analyze_file_id, чтобы прочитать текст из него»

Шпаргалка по лимитам

Лимит

Значение

Поддерживаемые форматы

JPEG, PNG, GIF, WebP

Объём тела запроса (inline)

48 МиБ

Одна изображение (base64 / внешний URL)

32 МиБ

Одна изображение (Files API)

64 МиБ

Длина внешнего URL

8192 символов

Максимум изображений на запрос

600

Примечания:

  • Изображения могут появляться только в сообщениях user; изображения в сообщениях system / assistant возвращают 400.

  • Только модель, предназначенная для работы с изображениями, принимает изображения; другие модели возвращают ошибку «This model does not support image».

  • Каждое изображение масштабируется перед подачей в модель; одна картинка потребляет не более ~384 токенов.

Проверка

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

Отсутствие ошибок означает, что сервер успешно запускается в режиме stdio (для реальных вызовов требуется настроенный DEEPSEEK_API_KEY).

Related MCP Connectors

Related MCP Servers