wenyan-mcp MCP — Use Cases, Install & Live Demo

Why use it

Key features

Markdown → WeChat-ready HTML with code blocks, tables, images
Register your own CSS themes for on-brand articles
Publishes straight to Drafts so you can review before sending
Images auto-uploaded to WeChat's permanent material library

Live Demo

What it looks like in practice

wenyan.replay ▶ ready

0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "wenyan": {
      "command": "npx",
      "args": [
        "-y",
        "wenyan-mcp"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "wenyan": {
      "command": "npx",
      "args": [
        "-y",
        "wenyan-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "wenyan": {
      "command": "npx",
      "args": [
        "-y",
        "wenyan-mcp"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wenyan": {
      "command": "npx",
      "args": [
        "-y",
        "wenyan-mcp"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "wenyan",
      "command": "npx",
      "args": [
        "-y",
        "wenyan-mcp"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json

{
  "context_servers": {
    "wenyan": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "wenyan-mcp"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add wenyan -- npx -y wenyan-mcp

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use wenyan-mcp

How to publish a Markdown article to WeChat 公众号 with wenyan-mcp

👤 Chinese tech/finance/creative bloggers on 微信公众号 ⏱ ~15 min intermediate

When to use: You draft in Obsidian/Typora/Claude and hate the WeChat web editor's formatting quirks.

Prerequisites

WeChat Official Account (订阅号 or 服务号) — mp.weixin.qq.com — requires identity verification
AppID + AppSecret — 公众号后台 → 开发 → 基本配置
Server IP whitelisted — Same page → IP白名单; add your current IP

Flow

Pick a theme

Use wenyan-mcp to list available themes. Show me the first 3.✓ Copied

→ Theme names with preview description
Publish to drafts

Take this Markdown article [paste] and publish it to 公众号 drafts using the 'orange-heart' theme. Title: '今天聊聊 MCP'.✓ Copied

→ Draft ID returned; article visible in 草稿箱
Review in WeChat and send

(in 公众号后台) Open the draft, preview on mobile, schedule or publish✓ Copied

→ Article live on 公众号

Outcome: Zero copy-paste, on-brand formatting, full control before the send button.

Pitfalls

IP not whitelisted — every call returns 40164 — Add the current machine's public IP in 公众号后台; if your IP changes often, use a static egress proxy
Images break because they point to external URLs — Use ![alt](local-path.png) — wenyan-mcp uploads them to WeChat's material library automatically

Combine with: filesystem

Maintain consistent brand styling across WeChat posts with wenyan

👤 Content teams, corporate marketers ⏱ ~10 min intermediate

When to use: Multiple authors contribute and output style drifts across posts.

Flow

Register a company theme

Register a new wenyan-mcp theme called 'acme-corp' from this CSS: [paste]. Confirm it's saved.✓ Copied

→ Theme shows in list_themes
Force all posts to use it

From now on, when I ask you to publish a WeChat article, always use the 'acme-corp' theme unless I say otherwise.✓ Copied

→ Applied on subsequent publishes

Outcome: Every author publishes visually consistent articles with zero CSS knowledge.

Combinations

Pair with other MCPs for X10 leverage

wenyan + filesystem

Publish an article that lives as a .md file on disk, with local image paths

Read ./posts/2026-04-agent-week.md and publish it to WeChat drafts using the 'acme-corp' theme.✓ Copied

wenyan + firecrawl

Scrape a public tech post and republish a localized summary

Summarize the latest Anthropic blog post into 800 words of Chinese, then publish to WeChat drafts.✓ Copied

Tools

What this MCP exposes

Tool	Inputs	When to call	Cost
list_themes		Pick a style before publishing	0
register_theme	name: str, css: str	Add a new brand style	0
delete_theme	name: str	Retire an old style	0
publish	markdown: str, title: str, theme?: str, author?: str, digest?: str, cover?: str	The payoff tool — pushes to drafts	WeChat API calls (free within quota)

Cost & Limits

What this costs to run

API quota: WeChat publish API: 100 drafts/day per account; material upload: 500/day
Tokens per call: Varies with article length; typical 2000-token post is fine
Monetary: Free — WeChat API is free with a verified account
Tip: Batch images into one article upload; each image counts against daily material quota

Security

Permissions, secrets, blast radius

Credential storage: WECHAT_APP_ID, WECHAT_APP_SECRET in env vars — never commit

Data egress: All API calls to api.weixin.qq.com

Troubleshooting

Common errors and fixes

40164 invalid IP

Add the machine's current public IP to 公众号 IP whitelist; the error returns the IP it saw

Verify: curl ifconfig.me to confirm your egress IP

40001 invalid credential / access_token

AppSecret wrong or access_token expired — wenyan caches it; restart the MCP to force refresh

Images not showing in the draft

Local paths must resolve; wenyan uploads them — if they're on a remote CDN, it downloads first

45009 api freq out of limit

You've hit daily material upload quota — wait until 0:00 Beijing time or reduce images

Alternatives

wenyan-mcp vs others

Alternative	When to use it instead	Tradeoff
md2wx / Doocs md-editor	You want a web editor you copy-paste from	Manual — no agent workflow
WeChat Official editor	Simple posts, no brand CSS	Notoriously fiddly with Markdown

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills