Skip to main content
Glama
vibe-token

DeepSeek Vision MCP Server

by vibe-token

DeepSeek Vision MCP Server

Ein DeepSeek-Vision-MCP-Server, erstellt mit FastMCP, der die drei Bild-Eingabsschnittstellen aus dem offiziellen Vision-Leitfaden für MCP-Clients wie opencode implementiert.

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

  • API: OpenAI-kompatibles Format, base_url = https://api.deepseek.com

Für die chinesische Dokumentation siehe README.zh.md.

Schnittstellen

Tool

Methode

Beschreibung

analyze_local_image(image_path, prompt, detail)

1. Base64 Inline

Liest ein lokales Bild und kodiert es in eine Data-URL, die in die Anfrage eingebettet ist; max. 32 MiB pro Bild

analyze_image_url(image_url, prompt, detail)

2. Externe URL

Übergibt einen öffentlich erreichbaren http(s)-Link, der vom Server heruntergeladen wird; URL ≤ 8192 Zeichen

analyze_file_id(file_id, prompt)

3. Files-API

Referenziert die file_id einer hochgeladenen Datei; bis zu 64 MiB pro Bild, über mehrere Anfragen wiederverwendbar

upload_image(image_path)

Files-API-Hilfsfunktion

Lädt eine lokale Bilddatei hoch (purpose=user_data) und gibt eine file-api-...-ID zurück

detail-Optionen: low (auf 512×512 verkleinert, schneller und günstiger), high, original, auto.

Related MCP server: Look At Pic MCP

Installation

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

Die Abhängigkeiten sind in requirements.txt festgelegt: fastmcp==3.4.7, openai==3.3.1.

Konfiguration

Füge Folgendes in den Abschnitt mcp von %HOMEPATH%\.config\opencode\opencode.jsonc ein:

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

Erhalte deinen API-Schlüssel von der DeepSeek-Plattform.

Verwendungsbeispiele

Nach der Konfiguration kannst du einfach in der Konversation fragen:

  • "Verwende analyze_local_image, um zu beschreiben, was in D:\pics\screenshot.png zu sehen ist"

  • "Verwende analyze_image_url, um dir https://example.com/photo.jpg anzusehen und die Szene zu beschreiben"

  • "Lade zuerst big_photo.png mit upload_image hoch und verwende dann analyze_file_id, um den Text darin zu lesen"

Grenzwert-Spickzettel

Limit

Wert

Unterstützte Formate

JPEG, PNG, GIF, WebP

Größe des Anfragekörpers (Inline)

48 MiB

Einzelnes Bild (Base64 / Externe URL)

32 MiB

Einzelnes Bild (Files-API)

64 MiB

Maximale URL-Länge

8192 Zeichen

Maximale Anzahl an Bildern pro Anfrage

600

Hinweise:

  • Bilder dürfen nur in user-Nachrichten vorkommen; Bilder in system- oder assistant-Nachrichten führen zu 400.

  • Nur das Vision-Modell akzeptiert Bilder; andere Modelle antworten mit „This model does not support image".

  • Jedes Bild wird vor der Verarbeitung durch das Modell verkleinert; ein einzelnes Bild verbraucht höchstens ~384 Tokens.

Überprüfung

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

Keine Fehlermeldungen bedeutet, dass der Server im StdIO-Modus problemlos startet (für echte Aufrufe muss DEEPSEEK_API_KEY konfiguriert sein).

Related MCP Connectors

Related MCP Servers