Wenyan MCP Server

Einführung

Wenyan ist ein plattformübergreifendes Markdown-Layout- und Veröffentlichungstool, das die Konvertierung und Veröffentlichung von Markdown mit einem Klick unterstützt auf:

• WeChat Official Accounts

• Zhihu

• Toutiao

• Und weitere Content-Plattformen (wird kontinuierlich erweitert)

Das Ziel von Wenyan ist: Autoren sollen sich auf den Inhalt konzentrieren, nicht auf das Layout und die Plattformanpassung.

Verschiedene Versionen von Wenyan

Wenyan ist derzeit in verschiedenen Formen verfügbar, um unterschiedliche Nutzungsszenarien abzudecken:

• macOS App Store Version - MAC Desktop-App

• Plattformübergreifende Desktop-Version - Windows/Linux

• CLI-Version - Befehlszeile / CI-automatisierte Veröffentlichung

• 👉 MCP-Version - Dieses Projekt

Was ist der Wenyan MCP Server?

Einfach ausgedrückt: Er schlägt die Brücke zwischen "KI-Schreiben" und "Veröffentlichung auf Official Accounts".

Basierend auf dem MCP-Protokoll können KI-Clients wie Claude Desktop jetzt direkt die Layout-Engine von Wenyan aufrufen. Nachdem Sie einen Artikel geschrieben haben, müssen Sie ihn nicht mehr in Drittanbieter-Editoren kopieren und einfügen, sondern lassen die KI das Layout direkt übernehmen und in den WeChat-Entwurfsordner verschieben.

Kernfunktionen:

• Umgehung von Layout-Tools: KI-generiertes Markdown wird direkt in WeChat-Rich-Text konvertiert und hochgeladen, was Zwischenschritte erspart.

• Konversationelles Layout: Sagen Sie der KI einfach: "Verwende ein orangefarbenes Design", und der Stil wird automatisch angewendet.

• Geschlossener Kreislauf ohne Fensterwechsel: Erledigen Sie alles – "Themenfindung -> Artikel schreiben -> Layout anpassen -> Entwurf speichern" – direkt im selben Chat-Fenster.

Praxis-Demo:

• Lassen Sie die KI Ihr Layout und die Veröffentlichung auf Official Accounts verwalten

• Moraya MCP Anwendungsfall: Vollständiges Management von WeChat Official Accounts

Funktionsmerkmale

• Veröffentlichung von Markdown mit einem Klick in den WeChat-Entwurfsordner

• Automatisches Hochladen lokaler Bilder und Cover

• Unterstützung für Remote-Server-Veröffentlichung (Umgehung von IP-Whitelist-Beschränkungen)

• Integrierte Auswahl an schönen Layout-Designs

• Unterstützung für benutzerdefinierte Designs

• Bereitstellung einer Standard-MCP-Tool-Schnittstelle

• Unterstützung für automatische KI-Aufrufe:

  • Markdown rendern

  • Themenverwaltung

  • Entwürfe veröffentlichen

Schnellstart

Installation

npm install -g @wenyan-md/mcp

Claude Desktop Konfiguration (claude_desktop_config.json)::

{
  "mcpServers": {
    "wenyan-mcp": {
      "command": "wenyan-mcp",
      "env": {
        "WECHAT_APP_ID": "your_app_id",
        "WECHAT_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Grundlegende Verwendung

Themen auflisten

Sagen Sie der KI:

Welche Official-Account-Themen kann ich derzeit verwenden?

KI-Antwort:

目前我支持的公众号主题包括以下这些，每个主题都有独特的风格和配色，适用于不同的内容调性：

1. **Default（默认）**  
   简洁经典的排版，适合长文阅读，通用性强。

2. **OrangeHeart（橙心）**  
   暖橙色调，优雅而富有活力，适合情感、生活类内容。
...

Thema registrieren

Sagen Sie der KI:

Hilf mir, dieses CSS (https://wenyan.yuzhi.tech/manhua.css) als neues Official-Account-Thema mit dem Namen "xiuluochang" zu registrieren.

KI-Antwort:

好的，已成功将 CSS 样式表注册为新的公众号主题，主题名称为：**xiuluochang**。

您现在可以在公众号后台选择该主题进行应用，样式将按照 `https://wenyan.yuzhi.tech/manhua.css` 的定义进行渲染。

如有需要进一步自定义或更换主题，随时告诉我！

Thema löschen

Sagen Sie der KI:

Lösche das Official-Account-Thema mit dem Namen "xiuluochang".

KI-Antwort:

公众号主题 “xiuluochang” 已成功删除。

Artikel veröffentlichen

Sagen Sie der KI:

Veröffentliche diesen Artikel mit dem Thema "phycat" auf dem WeChat Official Account: ./tests/publish.md

KI-Antwort:

文章已成功发布至微信公众号草稿箱！🎉

- **主题**：phycat  
- **媒体ID**：xxx

您可登录微信公众号后台，在「草稿箱」中查看并编辑文章，确认无误后即可一键发布。如需进一步排版优化、添加封面或设置摘要，我也可以协助您完成！

是否需要我帮您生成一篇发布文案或封面建议？ 😊

Konzepte

Konfiguration der Umgebungsvariablen

• WECHAT_APP_ID

• WECHAT_APP_SECRET

WeChat Official Account IP-Whitelist

Dokumentation zur Konfiguration: https://yuzhi.tech/docs/wenyan/upload

Artikelformat

Um Artikel korrekt hochzuladen, muss jedes Markdown-Dokument am Anfang ein frontmatter enthalten:

---
title: 在本地跑一个大语言模型(2) - 给模型提供外部知识库
cover: /Users/xxx/image.jpg
author: xxx
source_url: http://
---

Erklärung der Felder:

• title Artikeltitel (erforderlich)

• cover Artikel-Cover

  • Lokaler Pfad oder Web-Bild

  • Kann weggelassen werden, wenn der Text bereits Bilder enthält

• author Autor des Artikels

• source_url Original-URL

Beispielartikel

Bilder im Text und Artikel-Cover

Bevor ein Artikel auf dem Official Account veröffentlicht wird, verarbeitet Wenyan automatisch alle Bilder im Artikel gemäß den WeChat-Anforderungen und lädt sie in die Materialbibliothek des Official Accounts hoch. Derzeit unterstützt Wenyan folgende Bildquellen sehr gut:

• Absolute lokale Pfade (z. B.: /Users/xxx/image.jpg)

• Netzwerkpfade (z. B.: https://example.com/image.jpg)

• Relative Pfade des aktuellen Artikels (z. B.: ./assets/image.png)

Server-Modus

Im Vergleich zum rein lokalen lokalen Modus (Stdio Mode) bietet wenyan-mcp auch einen Remote-Client-Modus (Client–Server Mode). Beide Modi funktionieren identisch; Sie können den für Ihre Umgebung und Netzwerkbedingungen am besten geeigneten Modus wählen.

Im lokalen Modus ruft MCP direkt die WeChat Official Account API auf, um den Bild-Upload und die Entwurfsveröffentlichung abzuschließen.

flowchart LR
    MCP[Wenyan MCP] --> Wechat[公众号 API]

Im Remote-Client-Modus fungiert MCP als Client und sendet die Veröffentlichungsanfrage an den auf einem Cloud-Server bereitgestellten Wenyan-Server, der dann den Aufruf der WeChat Official Account API übernimmt.

flowchart LR
    MCP[Wenyan MCP] --> Server[Wenyan Server] --> Wechat[公众号 API]

Geeignet für:

• Benutzer ohne feste lokale IP, die häufig IP-Whitelists hinzufügen müssen

• Benutzer, die Teamarbeit benötigen

• Unterstützung für CI/CD-automatisierte Veröffentlichung

• Unterstützung für automatische Veröffentlichung durch KI-Agenten

Bereitstellung im Server-Modus

Claude Desktop Konfiguration::

{
  "mcpServers": {
    "wenyan-mcp": {
      "command": "wenyan-mcp",
      "args": ["--server", "https://api.example.com", "--api-key", "your-api-key"]
    }
  }
}

Veröffentlichung auf mehreren Official Accounts (Fortgeschritten)

Schritte:

• Zuerst den Server bereitstellen

• Konfigurieren Sie mehrere WeChat-Anmeldedaten auf der Server-Seite, siehe Dokumentation

• Lassen Sie den MCP-Client eine Verbindung zum Server herstellen

Sagen Sie der KI:

Veröffentliche diesen Artikel mit dem Thema "phycat" auf dem WeChat Official Account (your_app_id): ./tests/publish.md

Docker-Bereitstellung

Geeignet für Benutzer, die keine Node.js-Umgebung installieren möchten.

docker pull caol64/wenyan-mcp:latest

• Claude Desktop Konfiguration::

{
  "mcpServers": {
    "wenyan-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v", "/your/host/file/path:/mnt/host-downloads",
        "-e", "WECHAT_APP_ID=your_app_id",
        "-e", "WECHAT_APP_SECRET=your_app_secret",
        "-e", "HOST_FILE_PATH=/your/host/file/path",
        "caol64/wenyan-mcp"
      ]
    }
  }
}

Besondere Hinweise zur Docker-Konfiguration:

• Mount-Verzeichnis (-v): Das Verzeichnis mit Dateien/Bildern auf dem Host muss zwingend in das Verzeichnis /mnt/host-downloads im Container gemountet werden.

• Umgebungsvariable (HOST_FILE_PATH): Muss mit dem Pfad des gemounteten Datei-/Bildverzeichnisses auf dem Host übereinstimmen.

• Prinzip: Die lokalen Bilder, auf die in Ihrer Markdown-Datei/Ihrem Artikel verwiesen wird, sollten sich in diesem Verzeichnis befinden. Docker ordnet sie automatisch zu, sodass der Container sie lesen und hochladen kann.

Fehlerbehebung

Es wird empfohlen, den offiziellen Inspector zur Fehlerbehebung zu verwenden:

npx @modelcontextprotocol/inspector <command>

Nach erfolgreichem Start erscheint ein Hinweis wie dieser:

🔗 Open inspector with token pre-filled:
   http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=761c05058aa4f84ad02280e62d7a7e52ec0430d00c4c7a61492cca59f9eac299
   (Auto-open is disabled when authentication is enabled)

Besuchen Sie den obigen Link, um die Debugging-Seite zu öffnen.

1. Geben Sie den Startbefehl korrekt ein

2. Fügen Sie Umgebungsvariablen hinzu

3. Klicken Sie auf Connect

4. Wählen Sie Tools -> List Tools

5. Wählen Sie die zu debuggende Schnittstelle

6. Geben Sie die Parameter ein und klicken Sie auf Run Tool

7. Überprüfen Sie die vollständigen Parameter

Sponsoring

Wenn Sie das Gefühl haben, dass Wenyan Ihnen geholfen hat, können Sie meiner Katze ein paar Dosen Futter kaufen ❤️

https://yuzhi.tech/sponsor

Lizenz

Apache License Version 2.0