Markdown to WeChat Converter

Convierte texto Markdown en HTML compatible con cuentas oficiales de WeChat usando una clave de API externa.

Documentación

Servidor MCP del Editor de Markdown para WeChat

Este es un servidor Go basado en MCP (Model Context Protocol) que convierte texto Markdown a HTML en formato para cuentas oficiales de WeChat.

Características

  • 🚀 Conversión rápida: Convierte texto Markdown a HTML compatible con cuentas oficiales de WeChat
  • 🎨 Múltiples temas: Soporta 4 estilos de tema (predeterminado, ByteDance, estilo chino, estilo Apple)
  • 📊 Estadísticas detalladas: Proporciona recuento de palabras y tiempo de lectura estimado
  • 🔒 Autenticación segura: Soporta autenticación mediante API Key
  • 💬 Integración inteligente: Se integra sin problemas con modelos de lenguaje grandes (como Claude, GPT)

Sintaxis de Markdown compatible

Sintaxis básica

  • Encabezados (H1-H6)
  • Párrafos y saltos de línea
  • Texto en negrita y texto en cursiva
  • 内联代码
  • Enlace
  • ![图片](https://example.com/image.jpg)
  • Listas desordenadas y listas ordenadas
  • Bloques de cita

  • Línea divisoria (---)

Sintaxis extendida

  • Bloques de código (con resaltado de sintaxis)
  • Tablas
  • Notas al pie [^1]
  • Cuadros de aviso GFM (NOTE, TIP, IMPORTANT, WARNING, CAUTION)

Requisitos del entorno

  • Go 1.21 o superior
  • API Key del Editor de Markdown para WeChat

Instalación y configuración

1. Clonar o descargar el código

git clone https://github.com/geekjourneyx/md2wechat-mcp-server
cd md2wechat-mcp-server

2. Instalar dependencias

go mod tidy

3. Configurar la API Key

Después de obtener la API Key del Editor de Markdown para WeChat, configure la variable de entorno:

# Linux/macOS
export MD2WECHAT_API_KEY="wme_your_api_key_here"

# Windows
set MD2WECHAT_API_KEY=wme_your_api_key_here

4. Compilar y ejecutar

# 构建
go build -o md2wechat-mcp-server

# 运行
./md2wechat-mcp-server

Descripción de las herramientas MCP

convert_markdown

Convierte texto Markdown a HTML en formato para cuentas oficiales de WeChat.

Parámetros:

Nombre del parámetroTipoObligatorioDescripción
markdownstring✅Contenido de texto Markdown a convertir
themestring❌Estilo de tema, el valor predeterminado es "default"

Temas compatibles:

  • default - Estilo clásico predeterminado de WeChat
  • bytedance - Estilo ByteDance (estilo tecnológico moderno)
  • chinese - Estilo chino (estilo clásico y elegante)
  • apple - Estilo Apple (estilo con degradados visuales)

Resultado devuelto:

{
  "success": true,
  "html": "<section>...</section>",
  "theme": "default",
  "wordCount": 156,
  "estimatedReadTime": 1,
  "message": "Markdown 转换成功"
}

Uso en modelos de lenguaje grandes

Configuración de Claude Desktop

Agregue en claude_desktop_config.json:

{
  "mcpServers": {
    "md2wechat": {
      "command": "/path/to/md2wechat-mcp-server",
      "env": {
        "MD2WECHAT_API_KEY": "wme_your_api_key_here"
      }
    }
  }
}

Ejemplo de uso

Al conversar con Claude, puede solicitar de esta manera:

请帮我将以下 Markdown 文本转换为微信公众号格式:

# 我的文章标题

这是一个**重要**的段落。

## 子标题

- 列表项 1
- 列表项 2

使用中国风主题。

Claude llamará a la herramienta convert_markdown y devolverá el código HTML convertido.

Manejo de errores

El servidor maneja los siguientes errores comunes:

  • API Key no configurada o inválida
  • Contenido de Markdown vacío
  • Parámetros de tema no válidos
  • Problemas de conexión de red
  • Anomalías en el servicio de API

Límites de la API

  • El contenido de Markdown por solicitud no debe superar los 100KB
  • Cuota de API Key: 100 solicitudes/minuto
  • Tiempo de espera de solicitudes de red: 30 segundos

Desarrollo y contribuciones

Estructura del proyecto

md2wechat-mcp-server/
├── main.go          # 主程序文件
├── go.mod           # Go 模块依赖
├── README.md        # 说明文档
└── api_doc.md       # 原始 API 文档

Sugerencias de desarrollo

  1. Siga las normas de código de Go
  2. Agregue manejo de errores adecuado
  3. Escriba comentarios detallados
  4. Pruebe la integración de la API

Licencia

Este proyecto está bajo la licencia MIT.

Soporte y comentarios

Si tiene problemas o sugerencias, envíe un Issue o contacte al equipo de desarrollo.


Nota: Asegúrese de configurar correctamente la API Key antes de usar y cumpla con los términos de uso del Editor de Markdown para WeChat.