Wenyan MCP Server

Введение

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

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

• Zhihu

• Toutiao

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

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

Различные версии 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

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

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

Концепции

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

• WECHAT_APP_ID

• WECHAT_APP_SECRET

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

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

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

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

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

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

• title Заголовок статьи (обязательно)

• cover Обложка статьи

  • Локальный путь или ссылка на изображение

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

• author Автор статьи

• source_url Ссылка на оригинал

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

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

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

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

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

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

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

Помимо работы исключительно локально (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"]
    }
  }
}

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

Шаги:

• Сначала разверните 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