Wenyan MCP Server

Введение

Wenyan — это инструмент для верстки и публикации Markdown на различных платформах, поддерживающий преобразование и публикацию в один клик в:

• Официальные аккаунты WeChat

• Zhihu

• Toutiao

• И другие контент-платформы (список постоянно расширяется)

Цель Wenyan: позволить авторам сосредоточиться на контенте, а не на верстке и адаптации под платформы.

Related MCP server: WeChat Article MCP Server

Различные версии Wenyan

Wenyan в настоящее время доступен в нескольких форматах для различных сценариев использования:

• Версия для macOS App Store — настольное приложение для Mac

• Кроссплатформенная настольная версия — Windows/Linux

• CLI-версия — командная строка / автоматизация публикации в CI

• 👉 MCP-версия — данный проект

Что такое Wenyan MCP Server?

Проще говоря, он создает канал связи между «ИИ-письмом» и «публикацией в официальных аккаунтах WeChat».

Основываясь на протоколе MCP, ИИ-клиенты, такие как Claude Desktop, теперь могут напрямую вызывать движок верстки Wenyan. После написания статьи вам больше не нужно копировать и вставлять текст в сторонние редакторы — просто попросите ИИ выполнить верстку и сохранить статью в черновики WeChat.

Основные характеристики:

• Обход инструментов верстки: Сгенерированный ИИ Markdown напрямую преобразуется в форматированный текст WeChat и загружается, исключая промежуточные шаги.

• Диалоговая верстка: Просто напишите ИИ: «Смени стиль на оранжевый», и оформление применится автоматически.

• Замкнутый цикл без выхода из окна: Выполняйте все операции — «выбор темы -> написание статьи -> настройка верстки -> сохранение черновика» — в одном окне чата.

Демонстрация:

• Позвольте ИИ помочь вам управлять версткой и публикацией в официальном аккаунте

• Пример использования Moraya MCP: полное управление официальным аккаунтом WeChat

Функциональные возможности

• Публикация Markdown в черновики официального аккаунта WeChat в один клик

• Автоматическая загрузка локальных изображений и обложек

• Поддержка публикации через удаленный сервер (обход ограничений IP-белого списка)

• Встроенные наборы красивых тем оформления

• Поддержка пользовательских тем

• Предоставление стандартного интерфейса MCP Tool

• Поддержка автоматического вызова ИИ:

  • Рендеринг Markdown

  • Управление темами

  • Публикация черновиков

Быстрый старт

Установка

npm install -g @wenyan-md/mcp

Конфигурация Claude Desktop (claude_desktop_config.json)::

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

Базовое использование

Список тем

Скажите ИИ:

Какие темы для официальных аккаунтов доступны сейчас?

Ответ ИИ:

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

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

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

Регистрация темы

Скажите ИИ:

Помоги мне зарегистрировать этот CSS (https://wenyan.yuzhi.tech/manhua.css) как новую тему для официального аккаунта с названием: xiuluochang

Ответ ИИ:

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

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

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

Удаление темы

Скажите ИИ:

Удали тему для официального аккаунта с названием "xiuluochang"

Ответ ИИ:

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

Публикация статьи

Скажите ИИ:

Опубликуй эту статью в официальном аккаунте WeChat, используя тему phycat: ./tests/publish.md

Ответ ИИ:

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

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

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

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

Концепции

Настройка переменных окружения

[!IMPORTANT]

Убедитесь, что при запуске MCP настроены следующие переменные окружения, иначе интерфейс загрузки выдаст ошибку.

• WECHAT_APP_ID

• WECHAT_APP_SECRET

Белый список IP для официальных аккаунтов WeChat

[!IMPORTANT]

Убедитесь, что IP-адрес машины, на которой запущен Wenyan, добавлен в белый список IP в панели управления официального аккаунта WeChat, иначе интерфейс загрузки выдаст ошибку.

Документация по настройке: https://yuzhi.tech/docs/wenyan/upload

Формат статьи

Для корректной загрузки статьи в начале каждого Markdown-файла должен быть блок frontmatter:

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

Описание полей:

Примечания:

• Если обложка не указана, первое изображение в тексте будет автоматически использовано в качестве обложки

• Обложка поддерживает локальные пути и сетевые URL

• type и image_list используются для публикации сообщений с изображениями

Пример статьи

Изображения в тексте и обложка статьи

Перед публикацией статьи в официальном аккаунте Wenyan автоматически обработает все изображения в соответствии с требованиями WeChat, загрузив их в библиотеку материалов аккаунта. В настоящее время Wenyan отлично поддерживает следующие типы изображений:

• Абсолютные пути на локальном диске (например: /Users/xxx/image.jpg)

• Сетевые пути (например: https://example.com/image.jpg)

• Относительные пути в текущей статье (например: ./assets/image.png)

Публикация сообщений с изображениями («Маленькая зеленая книга»)

Отличие публикации сообщений с изображениями от обычных статей заключается в необходимости указания списка изображений в frontmatter. Поддерживаются два способа:

Способ 1: Использование type: image (рекомендуется)

Установите type: image в frontmatter, и CLI автоматически извлечет все изображения из текста:

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

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

Способ 2: Ручное указание image_list

Перечислите пути к изображениям прямо в frontmatter:

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

image_list поддерживает до 20 изображений, первое из которых будет обложкой.

Режим сервера

По сравнению с чисто локальным запуском (Stdio Mode), wenyan-mcp также предоставляет режим удаленного клиента (Client–Server Mode). Оба режима работают идентично, вы можете выбрать наиболее подходящий в зависимости от среды выполнения и сетевых условий.

В локальном режиме MCP напрямую вызывает API официального аккаунта WeChat для завершения загрузки изображений и публикации черновика.

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

В режиме удаленного клиента MCP выступает в качестве клиента, отправляя запрос на публикацию на Wenyan Server, развернутый на облачном сервере, который и выполняет вызов API WeChat.

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

Подходит для:

• Пользователей без фиксированного локального IP, которым приходится часто добавлять IP в белый список

• Пользователей, работающих в команде

• Поддержки автоматической публикации через CI/CD

• Поддержки автоматической публикации через ИИ-агентов

Развертывание в режиме сервера

Конфигурация Claude Desktop::

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

Публикация в несколько аккаунтов (продвинутый уровень)

[!IMPORTANT]

Для использования функции публикации в несколько аккаунтов необходимо использовать режим server.

Шаги:

• Сначала разверните server

• Настройте несколько учетных данных WeChat на стороне server, обратитесь к документации

• Подключите MCP-клиент к server

Скажите ИИ:

Опубликуй эту статью в официальном аккаунте WeChat (your_app_id), используя тему phycat: ./tests/publish.md

Развертывание через Docker

Подходит для пользователей, которые не хотят устанавливать среду Node.js.

docker pull caol64/wenyan-mcp:latest

• Конфигурация Claude Desktop::

{
  "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"
      ]
    }
  }
}

Особые примечания по конфигурации Docker:

• Монтирование каталогов (-v): Вы должны смонтировать каталог с файлами/изображениями хоста в /mnt/host-downloads внутри контейнера.

• Переменная окружения (HOST_FILE_PATH): Должна совпадать с путем к каталогу файлов/изображений на хосте.

• Принцип: Локальные изображения, на которые ссылается ваш Markdown-файл/статья, должны быть размещены в этом каталоге, Docker автоматически сопоставит их, чтобы контейнер мог прочитать и загрузить их.

Как отлаживать

Рекомендуется использовать официальный Inspector для отладки:

npx @modelcontextprotocol/inspector <command>

После успешного запуска появится сообщение, похожее на это:

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

Перейдите по указанной ссылке, чтобы открыть страницу отладки.

1. Правильно введите команду запуска

2. Добавьте переменные окружения

3. Нажмите Connect

4. Выберите Tools -> List Tools

5. Выберите интерфейс для отладки

6. Введите параметры и нажмите Run Tool

7. Просмотрите полные параметры

Спонсорство

Если вы считаете, что Wenyan полезен для вас, вы можете купить немного консервов для моей кошки ❤️

https://yuzhi.tech/sponsor

Лицензия

Apache License Version 2.0