wechat-mcp-publisher

Lokales MCP-Tool zum Veröffentlichen von Entwürfen für 微信-Official-Accounts. Es macht aus „fertiges HTML → Entwurfsordner des 微信-Official-Accounts“ einen einzigen LLM-Werkzeugaufruf: Bild-Upload, Austausch eingebetteter Bilder im Text durch 微信-URLs, Cover-Material und Entwurfserstellung – alles automatisch.

Basiert auf dem offiziellen mcp SDK (2.x MCPServer), stdio-Transport, Einzelkonto; Abhängigkeiten werden über uv verwaltet.

Werkzeuge (5)

access_token wird intern abgerufen, gecacht und bei Ablauf selbstheilend erneuert (stable_token + automatisches Aktualisieren und einmaliger Wiederholversuch bei 40001/42001); es wird nicht als Werkzeug bereitgestellt. Fehler werden einheitlich in chinesische Meldungen mit Hinweisen zur Fehlerbehebung umgewandelt (z. B. 40164 weist auf das Hinzufügen zur IP-Whitelist hin, 48001 auf ein verifiziertes Konto) und enthalten keine Anmeldedaten.

Related MCP server: WeChat Official Account MCP Server

Installation

uv sync
cp .env.example .env   # 填入 WECHAT_APP_ID / WECHAT_APP_SECRET

Anmeldedaten abrufen: mp.weixin.qq.com → Einstellungen und Entwicklung → Grundkonfiguration. Auf derselben Seite muss die öffentliche IP des lokalen Rechners in die IP-Whitelist eingetragen werden, sonst meldet der Token-Abruf 40164.

Nach der Veröffentlichung auf PyPI lässt es sich auch ohne Klonen direkt ausführen (in einem Verzeichnis, das .env enthält):

uvx wechat-mcp-publisher
# 或 pip install wechat-mcp-publisher && wechat-mcp-publisher

Die MCP-Client-Konfiguration kann dann auf "command": "uvx", "args": ["wechat-mcp-publisher"] vereinfacht werden.

Einbindung in MCP-Clients

Claude Code (empfohlen, ein Befehl):

claude mcp add wechat-mcp-publisher -- uv run --directory /你的路径/wechat-mcp-publisher python -m wechat_mcp_publisher

Projektweite Konfiguration (dieses Repository enthält bereits .mcp.json; Claude Code aktiviert sie beim Öffnen im Repository-Verzeichnis; beim ersten Mal muss die Vertrauensbestätigung unter /mcp erfolgen): kein manuelles Hinzufügen nötig.

Claude Desktop / andere Clients: Fügen Sie den Ausschnitt aus examples/mcp-client-config.example.json in die entsprechende Konfigurationsdatei ein.

Verwendungsbeispiele

Anweisung an das LLM:

Hilf mir, /path/article.html als Bild-Text-Entwurf für den 微信-Official-Account zu veröffentlichen, mit /path/cover.jpg als Titelbild.

Oder für eine Bildnachricht:

Veröffentliche diese drei Bilder /a.jpg /b.jpg /c.jpg als Bildnachrichten-Entwurf, Beschreibungstext: Wochenend-Fotos.

Eine Demonstration der echten API-Kette finden Sie in examples/simple_usage.py (Token → Upload → Entwurfserstellung; dient zugleich als Smoke-Test gegen die echte API).

Tests

uv run pytest

Alle API-Endpunkte sind über responses gemockt und lassen sich ohne echtes Konto ausführen.

Umfang und bekannte Einschränkungen

• Keine Markdown→HTML-Konvertierung: Der Haupttext wird als HTML entgegengenommen; für die Konvertierung nutzen Sie bitte Ihr vorhandenes md→html-Werkzeug.

• Keine Veröffentlichung (freepublish): Derzeit reicht es nur bis zum Entwurf; die Veröffentlichung bleibt einer Erweiterung nach der Konto-Verifizierung vorbehalten.

• Persönliches unverifiziertes Abo-Konto: Die Material-/Entwurfs-Endpunkte geben 48001 zurück; für die Validierung in der echten Umgebung wird ein verifiziertes Konto benötigt (Entwicklung und Tests sind nicht betroffen).

• HTML-微信-Kompatibilität: Der 微信-Editor erkennt nur eine Teilmenge von HTML mit Inline-Stilen; die Layout-Anpassung übernimmt das vorgelagerte Konvertierungswerkzeug. Dieses Tool prüft und repariert nicht.

• Materialanhäufung: Das Löschen eines Entwurfs löscht nicht die permanenten Materialbilder, die er belegt. Bei längerer Nutzung sollte gelegentlich im Backend des 微信-Official-Accounts aufgeräumt werden.

• Einzelkonto: Die Anmeldedaten stammen aus .env; ein Wechsel zwischen mehreren Konten wird nicht angeboten.