This project provides a server component for the Model Context Protocol (MCP) that automates the formatting and publishing of Markdown articles to WeChat Official Accounts. It targets AI developers and content creators who want to streamline their WeChat publishing workflow by leveraging AI for layout and distribution. The primary benefit is the automated, theme-consistent formatting and direct publishing of content to WeChat drafts.

How It Works

The server acts as an MCP endpoint, receiving Markdown content and metadata. It applies pre-defined themes for layout and then utilizes the WeChat Official Account platform's APIs to publish the formatted article to the draft box. The system supports automatic uploading of both local and network images referenced within the Markdown, simplifying the inclusion of media.

Quick Start & Requirements

• Local Run:

  git clone https://github.com/caol64/wenyan-mcp.git
  cd wenyan-mcp
  npm install
  npx tsc -b && npm run copy-assets
  

• Docker Run (Recommended):

  docker build -t wenyan-mcp .
  

• Prerequisites: Node.js environment for local build. WeChat Official Account App ID and App Secret are required. Server IP must be added to the WeChat Official Account IP whitelist.
• Configuration: Markdown files require a frontmatter with title and cover fields. Local image paths in Markdown must be accessible via volume mounting in Docker.
• Debugging: Use npx @modelcontextprotocol/inspector to access a debugging interface.
• Documentation: https://yuzhi.tech/docs/wenyan/upload

Highlighted Details

• Supports publishing to WeChat Official Account draft box.
• Automates image uploads (local and network).
• Integrates with the Model Context Protocol (MCP) for AI toolchain compatibility.
• Allows selection and preview of built-in article themes.

Maintenance & Community

• No specific contributor or community links (Discord, Slack, etc.) are provided in the README.

Licensing & Compatibility

• License: Apache License Version 2.0.
• Compatibility: Permissive license suitable for commercial use and integration with closed-source applications.

Limitations & Caveats

The project requires specific WeChat API credentials and IP whitelisting. Local image paths for Docker deployment must be carefully managed via volume mounts and the HOST_IMAGE_PATH environment variable. The README does not detail the specific themes available or provide extensive examples beyond basic frontmatter.