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.

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 es necesario copiar y pegar de un lado a otro en editores de terceros; simplemente deja que la IA le dé formato y lo envíe a tu 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, eliminando pasos intermedios.

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

• Ciclo cerrado sin salir de la ventana: En el mismo chat, gestiona sin problemas 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 la composición y 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 a borradores de cuentas oficiales 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 exquisitos integrados

• 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

Usa el tema phycat para publicar este artículo en la cuenta oficial de WeChat: ./tests/publish.md

Respuesta de la IA:

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

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

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

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

Conceptos

Configuración de variables de entorno

• WECHAT_APP_ID

• WECHAT_APP_SECRET

Lista blanca de IP de cuentas oficiales de WeChat

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:

• title Título del artículo (obligatorio)

• cover Portada del artículo

  • Ruta local o imagen de red

  • Si ya hay imágenes en el cuerpo del texto, se puede omitir

• author Autor del artículo

• source_url URL original

Artículo de ejemplo

Imágenes en el texto y portada del artículo

Antes de publicar el artículo en la cuenta oficial, Wenyan procesará automáticamente todas las imágenes 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)

Modo Servidor

En comparación con el Modo Local (Modo Stdio) que se ejecuta puramente de forma local, wenyan-mcp también proporciona el Modo Cliente-Servidor (Client–Server Mode). Ambos modos funcionan exactamente igual, y 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 de borradores.

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)

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

Usa el tema phycat para publicar este artículo en la cuenta oficial de WeChat(your_app_id): ./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 de montaje (-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