wechat-mcp-publisher

Herramienta MCP local para publicar borradores en la cuenta oficial de WeChat. Convierte «HTML ya escrito → buzón de borradores de la cuenta oficial» en una única llamada de herramienta LLM: subida de imágenes, sustitución de las imágenes incrustadas en el cuerpo por URL de WeChat, material de portada y creación de borradores, todo automático.

Basado en el SDK oficial mcp (2.x MCPServer), transporte stdio, cuenta única, dependencias gestionadas con uv.

Herramientas (5)

El access_token se obtiene internamente, se almacena en caché y se recupera automáticamente al caducar (stable_token + renovación automática y reintento una vez ante 40001/42001), no se expone como herramienta. Los errores se convierten uniformemente en mensajes en chino con indicaciones de resolución (por ejemplo, 40164 sugiere añadir la IP a la lista blanca; 48001 indica que se requiere una cuenta verificada) y no contienen credenciales.

Related MCP server: WeChat Official Account MCP Server

Instalación

uv sync
cp .env.example .env   # 填入 WECHAT_APP_ID / WECHAT_APP_SECRET

Obtención de credenciales: mp.weixin.qq.com → Configuración y desarrollo → Configuración básica. En la misma página hay que añadir la IP pública de esta máquina a la lista blanca de IP; de lo contrario, la obtención del token falla con 40164.

Una vez publicado en PyPI, también se puede ejecutar directamente sin clonar (en el directorio que contenga .env):

uvx wechat-mcp-publisher
# 或 pip install wechat-mcp-publisher && wechat-mcp-publisher

En ese caso, la configuración del cliente MCP se puede simplificar a "command": "uvx", "args": ["wechat-mcp-publisher"].

Integración con clientes MCP

Claude Code (recomendado, un solo comando):

claude mcp add wechat-mcp-publisher -- uv run --directory /你的路径/wechat-mcp-publisher python -m wechat_mcp_publisher

Configuración a nivel de proyecto (este repositorio ya incluye .mcp.json; Claude Code la activa al abrir el directorio del repositorio; la primera vez hay que confirmar la confianza en /mcp): no es necesario añadirla manualmente.

Claude Desktop / otros clientes: integra el fragmento de examples/mcp-client-config.example.json en el archivo de configuración correspondiente.

Ejemplo de uso

Dile al LLM:

Ayúdame a publicar /path/article.html como borrador de artículo de la cuenta oficial, con /path/cover.jpg como portada

O mensaje de imagen:

Envía estas tres imágenes /a.jpg /b.jpg /c.jpg como borrador de mensaje de imagen, texto de descripción: fotos del fin de semana

La demostración del flujo real de la API está en examples/simple_usage.py (token → subida → creación de borrador; sirve también como prueba de humo en el entorno real).

Pruebas

uv run pytest

Todos los endpoints se simulan con responses; se pueden ejecutar sin necesidad de una cuenta real.

Alcance y limitaciones conocidas

• No convierte markdown→HTML: la entrada del cuerpo es HTML; para la conversión, usa tu herramienta md→html existente

• No publica (freepublish): por ahora solo llega al borrador; la publicación queda para una futura ampliación tras la verificación de la cuenta

• Cuenta de suscripción personal sin verificar: los endpoints de materiales/borradores devuelven 48001; para probar en un entorno real se requiere una cuenta verificada (el desarrollo y las pruebas no se ven afectados)

• Compatibilidad HTML con WeChat: el editor de WeChat solo reconoce un subconjunto del HTML con estilos en línea; la adaptación de la maquetación corre a cargo de la herramienta de conversión upstream; esta herramienta no valida ni corrige

• Acumulación de materiales: eliminar un borrador no elimina las imágenes de material permanente que utiliza; con un uso prolongado conviene limpiarlas de vez en cuando en el panel de la cuenta oficial

• Cuenta única: las credenciales provienen de .env; no se ofrece cambio entre varias cuentas