Wenyan MCP

What caol64/wenyan-mcp MCP server does

The caol64/wenyan-mcp MCP server gives an MCP-compatible AI client access to Wenyan’s content formatting and publishing workflow. Its primary destination is the WeChat Official Account draft box. It can convert Markdown into WeChat rich text, apply a selected layout theme, upload referenced images, and submit the resulting article as a draft.

The project also describes support for image-message publishing, called “小绿书” in the documentation. A Markdown document can declare type: image or provide an image_list in frontmatter. The documented limit for that list is 20 images, with the first image used as the cover.

How it works

An AI client communicates with the caol64/wenyan-mcp MCP server through the standard MCP tool interface. Typical interactions include asking the client to list available themes, register a CSS-based theme, remove a theme, render an article, or publish a Markdown file using a named theme.

In local stdio mode, the MCP process sends image-upload and draft-publication requests directly to the WeChat Official Account API. In server mode, it acts as a client of a separately deployed Wenyan Server, which performs the WeChat API operations. Server mode is documented for environments without a stable local IP, team use, CI/CD workflows, AI-agent publishing, and publishing to multiple accounts. Multiple-account publishing requires server mode and credentials configured on the server.

Setup and configuration

The package is published as @wenyan-md/mcp and can be installed globally with npm. Claude Desktop can start the resulting wenyan-mcp executable and pass the required WeChat credentials through its environment configuration. WECHAT_APP_ID and WECHAT_APP_SECRET must be present when using direct local API access. The machine running the process also needs to be included in the WeChat Official Account IP allowlist.

Articles need YAML frontmatter at the beginning of the Markdown file. title is required. Optional fields include cover, author, source_url, comment settings, type, and image_list. A cover may be a local path or URL; if it is omitted, the first image in the body is used when available. Body images can use absolute local paths, remote URLs, or paths relative to the article.

Docker is another documented deployment option. The host directory containing Markdown files and local images must be mounted at /mnt/host-downloads, and HOST_FILE_PATH must match the host-side directory path. The image is caol64/wenyan-mcp.

Tools and capabilities

The caol64/wenyan-mcp MCP server documents these agent-callable capabilities:

• Render Markdown into the target publishing format.
• List, register, and delete formatting themes.
• Apply built-in or custom themes.
• Upload local and remote article images for WeChat handling.
• Save formatted articles to the WeChat draft box.
• Publish image messages using extracted or explicitly listed images.

Custom themes are registered from a CSS URL and assigned a name for later use.

Limitations and notes

Publishing depends on valid WeChat credentials and the required IP allowlist configuration. Local image handling in Docker depends on correct volume mapping and a matching HOST_FILE_PATH. The material identifies WeChat as the direct publishing target; although Wenyan itself supports other platforms, this MCP README specifically documents the WeChat publishing workflow. The remote mode also requires a separately deployed Wenyan Server and its associated configuration.

The project is licensed under Apache License 2.0.