mcp-plus: Claude Code Qwen Vision

Ermöglicht Claude Code, der reine Textmodelle wie DeepSeek verwendet, nahtlos Bildverständnisfähigkeiten zu erhalten.

Standard-Visionsmodell: qwen3.8-max Standard-Qwen-Adresse: https://dashscope.aliyuncs.com/compatible-mode/v1

Das Projekt bietet zwei Wege:

1. Transparentes Gateway (empfohlen): Der Benutzer fügt Bilder wie gewohnt ein, das Gateway übergibt die Bilder automatisch an Qwen und liefert die strukturierten visuellen Ergebnisse an DS. Während des Betriebs sind keine Befehle erforderlich, und es wird nicht auf die aktive Werkzeugnutzung von DS angewiesen.

2. Claude Code MCP-Plugin: Bietet das analyze_image-Tool und explizite Skills, geeignet zum direkten Lesen von Bilddateien im Projekt oder als Backup-Lösung.

Warum ein transparentes Gateway?

Der UserPromptSubmit-Hook von Claude Code bietet derzeit nur den Text prompt und übergibt weder das rohe Base64 noch den temporären Pfad des eingefügten Bildes an den Hook. Der Hook kann auch nicht zuverlässig erkennen, welches Modell der Benutzer in der Sitzung gewechselt hat. Daher können Skills, Hooks oder MCP allein nicht garantieren, dass Bilder nach dem Einfügen automatisch verarbeitet werden.

Das transparente Gateway arbeitet zwischen Claude Code und der Hauptmodellschnittstelle und kann sowohl das model in der Anfrage als auch die Bildinhaltsblöcke sehen:

Claude Code
    │ Anthropic /v1/messages（含图片）
    ▼
本地 Qwen Vision Gateway
    ├─ 无图片：直接转发
    ├─ 图片 + 纯文本主模型：Qwen 3.8 Max → 视觉 JSON → DS
    └─ 图片 + 已知多模态模型：可配置直接转发

Das gleiche Bild wird im Gateway-Prozess per SHA-256 zwischengespeichert, sodass Qwen nicht erneut aufgerufen wird, wenn Claude Code historische Nachrichten erneut sendet. Der Cache wird nur im Speicher gehalten; Bilder oder OCR-Ergebnisse werden nicht auf die Festplatte geschrieben.

Windows dauerhafte nahtlose Installation (VS Code empfohlen)

Voraussetzungen:

• Claude Code 2.1.128 oder höher

• Python 3.10+

• Bailian API-Key, der qwen3.8-max aufrufen kann

• Bereits konfigurierte DS/Claude Anthropic-kompatible Schnittstelle

Repository klonen:

git clone https://github.com/zjcdkj/mcp-plus.git
cd mcp-plus

Setzen Sie zuerst den Qwen-Key als Windows-Benutzerumgebungsvariable. Es wird empfohlen, ihn interaktiv in PowerShell einzugeben, um zu vermeiden, dass der Schlüssel in den Befehlsverlauf gelangt:

$qwenSecret = Read-Host "输入 DASHSCOPE API Key" -AsSecureString
$qwenPointer = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($qwenSecret)
try {
    $qwenEnvironment = [Microsoft.Win32.Registry]::CurrentUser.CreateSubKey("Environment")
    $qwenEnvironment.SetValue(
        "DASHSCOPE_API_KEY",
        [Runtime.InteropServices.Marshal]::PtrToStringBSTR($qwenPointer),
        [Microsoft.Win32.RegistryValueKind]::String
    )
} finally {
    if ($qwenEnvironment) { $qwenEnvironment.Dispose() }
    [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($qwenPointer)
}

Dauerhaftes Gateway installieren:

powershell -ExecutionPolicy Bypass -File .\scripts\install-windows-gateway.ps1

Der Installer wird:

1. Die Laufdateien nach %LOCALAPPDATA%\mcp-plus\qwen-vision kopieren;

2. Den Windows-Starteintrag mcp-plus Qwen Vision Gateway registrieren, der nach der Anmeldung des aktuellen Benutzers automatisch ausgeführt wird;

3. Fest auf http://127.0.0.1:15722 hören;

4. Die ursprüngliche DS/Claude-Upstream-Adresse speichern, aber keinen API-Key kopieren oder schreiben;

5. ANTHROPIC_BASE_URL in ~/.claude/settings.json auf das lokale Gateway umstellen.

Nach der Installation das VS Code-Fenster neu laden oder Claude Code vollständig beenden und erneut öffnen. Dienst überprüfen:

Invoke-RestMethod http://127.0.0.1:15722/health

Es sollte ok: true, qwen_model: qwen3.8-max und die ursprüngliche Upstream-Adresse angezeigt werden.

Temporäres Starten der Claude Code CLI

Wenn Sie die Konfiguration nicht dauerhaft ändern möchten, können Sie den temporären Starter nur in der aktuellen CLI-Sitzung verwenden. Setzen Sie den Qwen-Key in der aktuellen PowerShell-Sitzung:

$env:DASHSCOPE_API_KEY = "你的百炼 API Key"

Starten Sie Claude Code über den Starter. Geben Sie bei -UpstreamBaseUrl die ursprüngliche Hauptmodellschnittstelle ein; wenn Sie den nativen CC Switch verwenden, könnte die Adresse ähnlich wie die folgende sein:

.\scripts\start-claude-with-vision.ps1 `
  -UpstreamBaseUrl "http://127.0.0.1:15721"

Der Starter wird:

1. Ein verstecktes visuelles Gateway auf einem zufälligen lokalen Port starten;

2. ANTHROPIC_BASE_URL nur für diesen Claude Code-Prozess temporär ändern;

3. Vorhandene ANTHROPIC_AUTH_TOKEN, X-Api-Key und Anthropic Beta-Header beibehalten und weiterleiten;

4. Nach Beenden von Claude Code das Gateway schließen und die Umgebungsvariablen der aktuellen PowerShell wiederherstellen.

Es ändert ~/.claude/settings.json nicht dauerhaft. Danach können Sie wie gewohnt Bilder einfügen und Fragen stellen, ohne den Befehl /qwen-vision:* zu benötigen.

Multimodale Modelldurchleitung

Der Standardmodus always verarbeitet alle Bilder. Dies ist am zuverlässigsten für Umgebungen, in denen Aliase wie claude-sonnet-* über CC Switch auf DS abgebildet werden, da der Modellname in der Anfrage nicht unbedingt das tatsächliche Upstream-Modell darstellt.

Wenn die Modell-ID die Fähigkeiten genau widerspiegelt, kann die multimodale Modelldurchleitung konfiguriert werden:

$env:QWEN_VISION_PREPROCESS_MODE = "allowlist"
$env:QWEN_VISION_DIRECT_MODELS = "claude-*,qwen3.8-*,gpt-4o*"

• always: Alle Bilder werden zuerst von Qwen verarbeitet, Standardwert.

• allowlist: Modelle, die mit QWEN_VISION_DIRECT_MODELS übereinstimmen, erhalten das Originalbild direkt, andere Modelle verwenden Qwen.

• never: Transparente Bildvorverarbeitung vollständig deaktivieren, nur Anfragen weiterleiten.

Claude Code MCP-Plugin installieren

Das Plugin bietet Bildanalysefähigkeiten für Projektdateien, kann aber das transparente Gateway bei der Verarbeitung von über die Zwischenablage eingefügten Bildern nicht ersetzen.

Aus dem GitHub Marketplace installieren:

/plugin marketplace add zjcdkj/mcp-plus
/plugin install qwen-vision@zjcdkj-claude-tools
/reload-plugins

Führen Sie /mcp aus, Sie sollten qwen_vision als Connected sehen. Verwendungsbeispiel:

请使用 Qwen 分析 screenshots/error.png，提取报错并检查相关代码。

Oder explizit aufrufen:

/qwen-vision:analyze-image screenshots/error.png 提取报错文字和界面状态

Wenn das DS-Gateway kein MCP tool_use zurückgeben kann, verwenden Sie den deterministischen Backup-Skill:

/qwen-vision:analyze-image-direct "screenshots/error.png" "提取报错并判断原因"

Lokale Entwicklung und Überprüfung

claude --plugin-dir .
claude plugin validate .
python -m unittest discover -s .\tests -v
python -m compileall -q .\server .\gateway .\tests

Echte Bild-API-Tests erfordern, dass sich das Bild im aktuellen Projekt befindet:

$env:CLAUDE_PROJECT_DIR = (Get-Location).Path
python .\server\qwen_cli.py `
  --image ".\screenshots\test.png" `
  --question "提取截图中的文字和界面状态" `
  --mode ui

Konfigurationsoptionen

Sicherheitshinweise

• Bilder werden an Alibaba Cloud Bailian gesendet. Vor dem Senden sollten Produktionsanmeldeinformationen, persönliche Informationen und sensible Daten entfernt werden.

• Der API-Key wird nur aus Umgebungsvariablen gelesen und nicht in Plugins, Protokolle oder Antworten geschrieben.

• Das Projektdatei-MCP erlaubt nur das Lesen von PNG, JPEG, WebP innerhalb von CLAUDE_PROJECT_DIR.

• Das transparente Gateway hört standardmäßig nur auf 127.0.0.1.

• Der in Bildern erkannte Text wird stets als nicht vertrauenswürdige Daten behandelt und darf Benutzer- oder Systemanweisungen nicht überschreiben.

• Wenn die Gateway-Vorverarbeitung fehlschlägt, wird ein klarer Fehler zurückgegeben, und DS wird nicht stillschweigend ohne Bildinformationen angefragt.

Aktualisierung und Deinstallation

/plugin marketplace update zjcdkj-claude-tools
/reload-plugins

Deinstallation:

/plugin uninstall qwen-vision@zjcdkj-claude-tools
/plugin marketplace remove zjcdkj-claude-tools

Windows-dauerhaftes Gateway deinstallieren und ursprünglichen Upstream wiederherstellen:

powershell -ExecutionPolicy Bypass -File .\scripts\uninstall-windows-gateway.ps1

Der Deinstaller löscht DASHSCOPE_API_KEY nicht und stoppt keine unbekannten Programme, die denselben Port belegen. Der temporäre CLI-Starter ändert keine dauerhaften Konfigurationen; das Beenden des von ihm gestarteten Claude Code stoppt das Gateway.

Referenzen

• Claude Code MCP

• Claude Code Hooks

• Claude Code Plugin Marketplace

• Alibaba Cloud Bailian Vision Understanding

Lizenz

MIT