Servidor MCP Wenyan

Introducción

Wenyan es una herramienta de composición y publicación de Markdown multiplataforma que permite convertir y publicar con un solo clic en:

• Cuentas Oficiales de WeChat

• Zhihu

• Toutiao

• Y otras plataformas de contenido (en constante expansión)

El objetivo de Wenyan es: permitir que los escritores se concentren en el contenido, no en la composición ni en la adaptación a la plataforma.

Related MCP server: WeChat Article MCP Server

Diferentes versiones de Wenyan

Wenyan ofrece actualmente varias formas para cubrir diferentes escenarios de uso:

• Versión de macOS App Store - Aplicación de escritorio para Mac

• Versión de escritorio multiplataforma - Windows/Linux

• Versión CLI - Línea de comandos / Publicación automatizada en CI

• 👉 Versión MCP - Este proyecto

¿Qué es el Servidor MCP Wenyan?

En pocas palabras, abre un canal entre la "escritura con IA" y la "publicación en Cuentas Oficiales".

Basado en el protocolo MCP, los clientes de IA como Claude Desktop ahora pueden invocar directamente el motor de composición de Wenyan. Después de escribir un artículo, no necesitas copiar y pegar de un lado a otro en editores de terceros; simplemente deja que la IA le dé formato y lo envíe al borrador de WeChat.

Características principales:

• Evita las herramientas de composición: El Markdown generado por la IA se convierte directamente a texto enriquecido de WeChat y se sube, ahorrando pasos intermedios.

• Composición conversacional: Escribe directamente a la IA "cambia a un estilo naranja" y el estilo se aplicará automáticamente.

• Ciclo cerrado sin salir de la ventana: En el mismo chat, gestiona todo el proceso: "pensar en temas -> escribir artículos -> ajustar el formato -> guardar borradores".

Demostración práctica:

• Deja que la IA te ayude a gestionar el formato y la publicación de tu cuenta oficial

• Caso de uso de Moraya MCP: Gestión completa de Cuentas Oficiales de WeChat

Características funcionales

• Publicación con un clic de Markdown al borrador de la Cuenta Oficial de WeChat

• Carga automática de imágenes locales y portadas

• Soporte para publicación en servidor remoto (evitando restricciones de lista blanca de IP)

• Temas de composición integrados y elegantes

• Soporte para temas personalizados

• Proporciona una interfaz estándar de herramientas MCP

• Soporte para invocación automática por IA:

  • Renderizado de Markdown

  • Gestión de temas

  • Publicación de borradores

Inicio rápido

Instalación

npm install -g @wenyan-md/mcp

Configuración de 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"
      }
    }
  }
}

Uso básico

Listar temas

Dile a la IA

¿Qué temas de cuentas oficiales puedes usar actualmente?

Respuesta de la IA:

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

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

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

Registrar un tema

Dile a la IA

Ayúdame a registrar este css (https://wenyan.yuzhi.tech/manhua.css) como un nuevo tema de cuenta oficial, con el nombre: xiuluochang

Respuesta de la IA:

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

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

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

Eliminar un tema

Dile a la IA

Elimina el tema de cuenta oficial llamado "xiuluochang"

Respuesta de la IA:

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

Publicar un artículo

Dile a la IA

Publica este artículo en la cuenta oficial de WeChat usando el tema phycat: ./tests/publish.md

Respuesta de la IA:

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

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

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

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

Conceptos

Configuración de variables de entorno

[!IMPORTANT]

Asegúrate de que las siguientes variables de entorno estén configuradas al iniciar MCP, de lo contrario, la interfaz de carga fallará.

• WECHAT_APP_ID

• WECHAT_APP_SECRET

Lista blanca de IP de la Cuenta Oficial de WeChat

[!IMPORTANT]

Asegúrate de que la IP de la máquina que ejecuta Wenyan se haya agregado a la lista blanca de IP en el backend de la cuenta oficial de WeChat, de lo contrario, la interfaz de carga fallará.

Documentación de configuración: https://yuzhi.tech/docs/wenyan/upload

Formato del artículo

Para subir el artículo correctamente, cada Markdown debe incluir un frontmatter en la parte superior:

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

Descripción de los campos:

Notas:

• Si no se especifica una portada, se utilizará automáticamente la primera imagen del cuerpo como portada

• La portada admite rutas locales y URL web

• type e image_list se utilizan para la publicación de mensajes de imagen

Ejemplo de artículo

Imágenes dentro del artículo y portada

Antes de publicar el artículo en la cuenta oficial, Wenyan procesará automáticamente todas las imágenes dentro del artículo según los requisitos de WeChat y las subirá a la biblioteca de materiales de la cuenta oficial. Actualmente, Wenyan admite bien las siguientes imágenes:

• Rutas absolutas del disco duro local (ej.: /Users/xxx/image.jpg)

• Rutas de red (ej.: https://example.com/image.jpg)

• Rutas relativas del artículo actual (ej.: ./assets/image.png)

Publicar mensajes de imagen ("pequeño libro verde")

La diferencia entre publicar mensajes de imagen y mensajes de texto/imagen es que se debe especificar una lista de imágenes en el frontmatter. Se admiten dos métodos:

Método 1: Usar type: image (recomendado)

Establece type: image en el frontmatter, y la CLI extraerá automáticamente todas las imágenes del cuerpo:

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

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

Método 2: Especificar manualmente image_list

Enumera las rutas de las imágenes directamente en el frontmatter:

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

image_list admite hasta 20 imágenes, la primera será la portada.

Modo Servidor

En comparación con el Modo Local (Modo Stdio) que se ejecuta puramente de forma local, wenyan-mcp también ofrece el Modo Cliente-Servidor (Client–Server Mode). Ambos modos funcionan exactamente igual, puedes elegir el que mejor se adapte a tu entorno de ejecución y condiciones de red.

En el modo local, MCP llama directamente a la API de la cuenta oficial de WeChat para completar la carga de imágenes y la publicación del borrador.

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

En el modo cliente-servidor, MCP actúa como cliente y envía la solicitud de publicación al servidor Wenyan desplegado en la nube, y el servidor completa la llamada a la API de la cuenta oficial de WeChat.

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

Adecuado para:

• Usuarios sin IP fija local que necesitan agregar IP a la lista blanca con frecuencia

• Usuarios que necesitan colaboración en equipo

• Soporte para publicación automática en CI/CD

• Soporte para publicación automática por agentes de IA

Despliegue en modo servidor

Configuración de Claude Desktop：：

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

Publicación en múltiples cuentas oficiales (avanzado)

[!IMPORTANT]

Debes usar el modo server para utilizar la función de publicación en múltiples cuentas oficiales.

Pasos:

• Primero despliega el server

• Configura múltiples credenciales de WeChat en el lado del server, consulta la documentación

• Haz que el cliente MCP se conecte al server

Dile a la IA

Publica este artículo en la cuenta oficial de WeChat (your_app_id) usando el tema phycat: ./tests/publish.md

Despliegue con Docker

Adecuado para usuarios que no desean instalar el entorno Node.js.

docker pull caol64/wenyan-mcp:latest

• Configuración de 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"
      ]
    }
  }
}

Nota especial sobre la configuración de Docker:

• Directorio montado (-v): Debes montar el directorio de archivos/imágenes del host en /mnt/host-downloads dentro del contenedor.

• Variable de entorno (HOST_FILE_PATH): Debe ser consistente con la ruta del directorio de archivos/imágenes montado en el host.

• Principio: Las imágenes locales a las que hace referencia tu archivo Markdown/artículo deben colocarse en este directorio, y Docker las asignará automáticamente para que el contenedor pueda leerlas y subirlas.

Cómo depurar

Se recomienda utilizar el Inspector oficial para la depuración:

npx @modelcontextprotocol/inspector <command>

Si el inicio es exitoso, aparecerá un mensaje similar:

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

Accede al enlace anterior para abrir la página de depuración.

1. Completa correctamente el comando de inicio

2. Agrega variables de entorno

3. Haz clic en Connect

4. Selecciona Tools -> List Tools

5. Selecciona la interfaz a depurar

6. Completa los parámetros y haz clic en Run Tool

7. Visualiza los parámetros completos

Patrocinio

Si crees que Wenyan te ha sido útil, puedes comprarle algo de comida a mi gato ❤️

https://yuzhi.tech/sponsor

Licencia

Apache License Version 2.0