wenyan-mcp MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

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

라이브 데모

실제 사용 모습

wenyan.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/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
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

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

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

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

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

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

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

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

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

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

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

context_servers에 추가. 저장 시 Zed가 핫 리로드.

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

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: wenyan-mcp

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

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

언제 쓸까: You draft in Obsidian/Typora/Claude and hate the WeChat web editor's formatting quirks.

사전 조건

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

흐름

Pick a theme

Use wenyan-mcp to list available themes. Show me the first 3.✓ 복사됨

→ 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'.✓ 복사됨

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

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

→ Article live on 公众号

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

함정

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

함께 쓰기: filesystem

Maintain consistent brand styling across WeChat posts with wenyan

👤 Content teams, corporate marketers ⏱ ~10 min intermediate

언제 쓸까: Multiple authors contribute and output style drifts across posts.

흐름

Register a company theme

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

→ 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.✓ 복사됨

→ Applied on subsequent publishes

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

조합

다른 MCP와 조합해 10배 효율

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.✓ 복사됨

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.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
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)

비용 및 제한

운영 비용

API 쿼터: WeChat publish API: 100 drafts/day per account; material upload: 500/day
호출당 토큰: Varies with article length; typical 2000-token post is fine
금액: Free — WeChat API is free with a verified account
팁: Batch images into one article upload; each image counts against daily material quota

보안

권한, 시크릿, 파급범위

자격 증명 저장: WECHAT_APP_ID, WECHAT_APP_SECRET in env vars — never commit

데이터 외부 송신: All API calls to api.weixin.qq.com

문제 해결

자주 발생하는 오류와 해결

40164 invalid IP

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

확인: 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

대안

wenyan-mcp 다른 것과 비교

대안	언제 쓰나	단점/장점
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

wenyan-mcp