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 weiteren Content-Plattformen (wird ständig erweitert)

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

Related MCP server: WeChat Article MCP Server

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 nun direkt die Layout-Engine von Wenyan aufrufen. Nach dem Schreiben eines Artikels müssen Sie nicht mehr zwischen Drittanbieter-Editoren hin- und herkopieren; lassen Sie die KI das Layout direkt für Sie übernehmen und den Entwurf in Ihrem WeChat-Entwurfsordner speichern.

Kernfunktionen:

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

• 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.

Praxisbeispiele:

• Lassen Sie die KI das Layout und die Veröffentlichung Ihres Official Accounts verwalten

• Moraya MCP Anwendungsfall: Vollständige Verwaltung von WeChat Official Accounts

Funktionsmerkmale

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

• Automatischer Upload von lokalen Bildern und Titelbildern

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

• Integrierte Auswahl an eleganten Layout-Themen

• Unterstützung für benutzerdefinierte Themen

• Bereitstellung einer Standard-MCP-Tool-Schnittstelle

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

  • Markdown-Rendering

  • Themenverwaltung

  • Entwurfsveröffentlichung

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（橙心）**  
   暖橙色调，优雅而富有活力，适合情感、生活类内容。
...

Themen 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` 的定义进行渲染。

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

Themen 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

[!IMPORTANT]

Bitte stellen Sie sicher, dass beim Start von MCP die folgenden Umgebungsvariablen konfiguriert sind, da sonst die Upload-Schnittstelle fehlschlägt.

• WECHAT_APP_ID

• WECHAT_APP_SECRET

WeChat Official Account IP-Whitelist

[!IMPORTANT]

Bitte stellen Sie sicher, dass die IP-Adresse des Rechners, auf dem Wenyan läuft, zur IP-Whitelist im Backend des WeChat Official Accounts hinzugefügt wurde, da sonst die Upload-Schnittstelle fehlschlägt.

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

Artikelformat

Um Artikel korrekt hochzuladen, muss jeder Markdown-Artikel am Anfang ein frontmatter-Segment enthalten:

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

Feld-Erklärung:

Hinweis:

• Wenn kein Cover angegeben ist, wird automatisch das erste Bild des Artikels als Cover verwendet.

• Cover unterstützt lokale Pfade und Web-URLs.

• type und image_list werden für die Veröffentlichung von Bildnachrichten verwendet.

Beispielartikel

Bilder im Artikel und Titelbild

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)

Veröffentlichung von Bildnachrichten (Kleines grünes Buch)

Der Unterschied zwischen der Veröffentlichung von Bildnachrichten und Text-Bild-Nachrichten besteht darin, dass im Frontmatter eine Bildliste angegeben werden muss. Es werden zwei Methoden unterstützt:

Methode 1: Verwendung von type: image (empfohlen)

Setzen Sie type: image im Frontmatter; die CLI extrahiert automatisch alle Bilder aus dem Text:

---
title: 人勤春来早，读书正当时
type: image
---

![](./1.jpeg)
![](./2.jpeg)
![](./3.jpeg)

Methode 2: Manuelle Angabe von image_list

Listen Sie die Bildpfade direkt im Frontmatter auf:

---
title: 人勤春来早，读书正当时
image_list:
  - ./1.jpeg
  - ./2.jpeg
  - ./3.jpeg
  - ./4.jpeg
  - ./5.jpeg
---

image_list unterstützt maximal 20 Bilder, das erste Bild dient als Cover.

Server-Modus

Im Vergleich zum rein lokalen Betrieb (Stdio-Modus) bietet wenyan-mcp auch einen Remote-Client-Modus (Client-Server-Modus). 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, der die Veröffentlichungsanfrage an einen auf einem Cloud-Server bereitgestellten Wenyan-Server sendet, welcher dann den API-Aufruf für den WeChat Official Account durchführt.

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 im Team zusammenarbeiten

• 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)

[!IMPORTANT]

Der server-Modus muss verwendet werden, um die Funktion zur Veröffentlichung auf mehreren Official Accounts zu nutzen.

Schritte:

• Zuerst den server bereitstellen.

• Auf der server-Seite mehrere WeChat-Anmeldedaten konfigurieren, siehe Dokumentation.

• Den MCP-Client mit dem server verbinden.

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): Sie müssen das Datei-/Bildverzeichnis des Hosts in den Container unter /mnt/host-downloads mounten.

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

• Prinzip: Die lokalen Bilder, auf die Ihre Markdown-Datei/Ihr Artikel verweist, 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 testende Schnittstelle aus.

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

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

Sponsoring

Wenn Sie der Meinung sind, dass Wenyan Ihnen hilft, können Sie meiner Katze ein paar Dosen Futter kaufen ❤️

https://yuzhi.tech/sponsor

Lizenz

Apache License Version 2.0