# caol64/wenyan-mcp [Health: Active]

**Category:** 🛠️ Other Tools and Integrations  
**Repository:** https://github.com/caol64/wenyan-mcp  
**GitHub Stars:** 1313  
**npm Downloads (last month):** 905396  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/caol64-wenyan-mcp

## Description
Wenyan MCP Server, which lets AI automatically format Markdown articles and publish them to WeChat GZH.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "wenyan-mcp": {
    "command": "npx",
    "args": ["-y","@modelcontextprotocol/inspector"],
    "env": {
      "WECHAT_APP_ID": "",
      "WECHAT_APP_SECRET": ""
    }
  }
}
```

**Requires environment variables:** `WECHAT_APP_ID`, `WECHAT_APP_SECRET` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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. The README does not provide a complete tool schema or parameter reference, so exact tool names and argument shapes should be inspected from the connected client.

## 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. The README shows Claude Desktop configuration and does not establish compatibility with other named MCP clients.

_Full upstream README: https://allmcps.com/mcp/caol64-wenyan-mcp/readme_