glm-vision-mcp

Ein MCP-Server, der das GLM-4.6V-Flash-Modell von Zhipu (kostenloses Vision-Modell) kapselt und jedem MCP-Client ein analyze_image-Tool bereitstellt, das Einzelbild-/Mehrbildanalyse, OCR und Mehrbildvergleich unterstützt.

Funktionen

Related MCP server: vision-mcp

Systemanforderungen

• Python >= 3.10

• API-Key der Zhipu Open Platform (https://open.bigmodel.cn/usercenter/apikeys), glm-4.6v-flash ist kostenlos

• Um die Wahrscheinlichkeit von Ratenlimits weiter zu verringern, können Sie mehrere Konten registrieren und jeweils einen Key erhalten; bei der Konfiguration durch Kommas getrennt angeben

Installation

cd glm-vision-mcp
python -m venv .venv
.venv\Scripts\pip install -r requirements.txt

Start

# stdio 模式（MCP 客户端默认方式）
$env:ZHIPU_API_KEY = "你的Key"
.venv\Scripts\python server.py

# SSE 调试模式（无鉴权，仅限本机）
.venv\Scripts\python server.py --sse 8090

Client-Konfiguration

Codex (~/.codex/config.toml)

[mcp_servers.glm-vision]
command = "C:\\绝对路径\\glm-vision-mcp\\.venv\\Scripts\\python.exe"
args = ["C:\\绝对路径\\glm-vision-mcp\\server.py"]

[mcp_servers.glm-vision.env]
ZHIPU_API_KEY = "你的Key"
# GLM_VISION_MODELS = "glm-4.6v-flash"
# GLM_API_BASE = "https://open.bigmodel.cn/api/paas/v4/chat/completions"

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "glm-vision": {
      "command": "C:\\绝对路径\\glm-vision-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\绝对路径\\glm-vision-mcp\\server.py"],
      "env": { "ZHIPU_API_KEY": "你的Key" }
    }
  }
}

Tool-Schnittstelle

analyze_image(images, prompt, temperature, max_tokens, thinking)

Umgebungsvariablen

Hinweise

• Lokale Bilder maximal 10 MB pro Bild, unterstützt jpg/jpeg/png/webp/gif/bmp

• Das kostenlose Modell kann zu Spitzenzeiten Ratenlimits haben; nur wenn alle Keys und alle Modelle limitiert sind, wird ein Fehler gemeldet; warten Sie 15~30 Sekunden und versuchen Sie es außerhalb der Spitzenzeiten erneut

• Fehler wie 401/400 (keine Ratenlimits) werden nicht herabgestuft oder erneut versucht, sondern direkt zurückgegeben, um die Fehlersuche in der Konfiguration zu erleichtern

Verifikation

# 离线检查（不联网）
.venv\Scripts\python test_smoke.py

# 联网冒烟：MCP 握手 + analyze_image 真实调用
$env:ZHIPU_API_KEY = "你的Key"
.venv\Scripts\python test_smoke.py --live