vision-mcp

Visueller MCP-Server basierend auf Alibaba Cloud Bailian DashScope (Qwen-VL). Bietet Bildverständnisfunktionen für Clients wie Claude Code, Trae, CodeBuddy über das MCP-Protokoll.

Funktionen

• analyze_image — Allgemeine Bildanalyse (unterstützt lokale Dateipfade / öffentliche URLs / Data-URLs)

• screenshot_analyze — UI-/Bildschirmfotoanalyse

Related MCP server: image-mcp

Unterstützte Modelle

Schnellstart

1. Abhängigkeiten installieren

python -m venv .venv
# Windows
.venv\Scripts\pip install -r requirements.txt
# Linux / macOS
.venv/bin/pip install -r requirements.txt

2. API-Schlüssel konfigurieren

Erstellen Sie eine .env-Datei im Projektstammverzeichnis (wird beim Start des MCP-Servers automatisch gelesen):

DASHSCOPE_API_KEY=sk-你的密钥

Antragsadresse: Alibaba Cloud Bailian-Konsole

3. Starten

# Windows
.venv\Scripts\python vision_mcp_server.py
# Linux / macOS
.venv/bin/python vision_mcp_server.py

Unterstützte Modelle auflisten:

python vision_mcp_server.py --list

In MCP-Client einbinden

Fügen Sie in der MCP-Konfiguration des Clients (z. B. mcp.json oder .mcp.json) Folgendes hinzu:

{
  "mcpServers": {
    "vision": {
      "command": "/path/to/vision-mcp/.venv/bin/python",
      "args": ["/path/to/vision-mcp/vision_mcp_server.py"],
      "env": {}
    }
  }
}

Testen

# 协议冒烟测试（无需 API Key）
.venv/bin/python smoke_test.py

# 真实调用测试（需配置 API Key，使用本地测试图）
.venv/bin/python live_test.py

Hinweise

• Der DashScope-Server kann beim Herunterladen öffentlicher Bild-URLs aus dem Ausland zeitüberschreiten. Verwenden Sie lokale Dateipfade oder in China erreichbare URLs.

• Der API-Schlüssel wird über die .env-Datei bereitgestellt und nicht in der Konfigurationsdatei gespeichert.

Lizenz

MIT