About wechat-writer-mcp
wechat-writer-mcp is an MCP server for technical writers that turns source material into WeChat Official Account drafts. It imports content, formats it for WeChat, estimates originality against the user's own drafts, and saves drafts without publishing them.
Key features
- 01Import Markdown files or webpage URLs
- 02Format content as WeChat-ready HTML
- 03Generate title and summary suggestions
- 04Compare against past drafts for originality
- 05Save content to the WeChat draft box
- 06Never publish or send automatically
Use cases
- 01Convert a Markdown article into a WeChat draft
- 02Format code blocks and add templates
- 03Review similarity to previous drafts
- 04Prepare an article without publishing
MCP support
Exposes four tools to MCP clients for importing source material, formatting WeChat content, estimating originality, and saving drafts through the WeChat draft API. It does not publish or send articles.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y wechat-writer-mcpWECHAT_APP_ID微信公众号 AppID(mp.weixin.qq.com → 开发 → 基本配置)WECHAT_APP_SECRETSecret微信公众号 AppSecret(mp.weixin.qq.com → 开发 → 基本配置)WECHAT_COVERS_DIR封面图片目录,默认 ~/Pictures/wechat-coversWECHAT_DEFAULT_AUTHORSecret草稿默认作者名WECHAT_API_TIMEOUT微信 API 超时毫秒数,默认 15000Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
4Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | No | Webpage URL (required when source_type=url) |
| path | string | No | Local file path (required when source_type=file) |
| source_type | enum | Yes | Source type: file reads a local file; url fetches the main text of a webpagefile | url |
Details
From the project READMEwechat-writer-mcp
面向技术博主的 AI 内容加工流水线 MCP —— 从原始素材到公众号草稿箱,只存草稿,不自动发布。
⚡ 快速开始
一键启动
npx wechat-writer-mcp
MCP 配置
{
"mcpServers": {
"wechat-writer": {
"command": "npx",
"args": ["wechat-writer-mcp"],
"env": {
"WECHAT_APP_ID": "your_app_id",
"WECHAT_APP_SECRET": "your_app_secret"
}
}
}
}
立即体验
AI指令: "导入 ./my-article.md,帮我排版成公众号格式,检查原创度后存入草稿箱"
🛠️ 核心功能
- 4 个专业工具 - 导入素材、智能排版、原创检测、存入草稿箱
- 官方 API - 基于微信公众号草稿箱 API,完全合规
- 内容加工 - 段落切分、代码块处理、超链接转脚注、头尾模板、标题候选
- 安全第一 - 永远只存草稿箱,永远不自动群发/发布
- 即插即用 - 支持 Claude Code、Cursor、Claude Desktop
📦 工具列表
| 工具 | 说明 | 输入 | 输出 |
|---|---|---|---|
import_source | 导入原始内容 | 本地 markdown 文件或网页 URL | raw_markdown + 标题/字数等元数据 |
transform_for_wechat | 公众号智能排版 | markdown 内容 | 适配 HTML + 3 个标题候选 + 摘要建议 |
estimate_originality | 原创度自评 | 文章内容 | 原创度评分 + 与历史草稿的相似段落 |
save_to_wechat_draft | 存入草稿箱 | 标题 + HTML 内容 | media_id + 后台链接 |
💡 使用流程
用户: 导入 ./my-article.md
AI: [调 import_source] 已读入 838 字 markdown
标题识别:《我用 Claude Code 三周做了一个 MCP Server》
用户: 帮我按公众号风格排版
AI: [调 transform_for_wechat]
- 代码块已处理为公众号可显示格式
- 已应用头尾模板
- 3 个标题候选:
1. 我用 Claude Code 三周做了一个 MCP Server
2. 我用 Claude Code 三周做了一个 MCP Server:完整实践指南
3. 一文读懂我用 Claude Code 三周做了一个 MCP Server
要哪个?
用户: 用 1,检查下原创度
AI: [调 estimate_originality]
深度原创(92/100)
建议:可以标记"原创"
历史比对:无重复内容
用户: OK 存草稿箱
AI: [调 save_to_wechat_draft]
✅ 已存入公众号草稿箱
→ 请前往 mp.weixin.qq.com → 内容管理 → 草稿箱 手动发送
⚙️ 安装配置
方式一:npx 直接运行(推荐)
npx wechat-writer-mcp
方式二:本地安装
git clone https://github.com/datoushiwo/wechat-writer-mcp.git
cd wechat-writer-mcp
npm install
npm run build
环境变量
cp .env.example .env
| 变量 | 必填 | 说明 |
|---|---|---|
WECHAT_APP_ID | ✅ | 公众号 AppID |
WECHAT_APP_SECRET | ✅ | 公众号 AppSecret |
WECHAT_COVERS_DIR | 封面图片目录,默认 ~/Pictures/wechat-covers | |
WECHAT_DEFAULT_AUTHOR | 默认作者名 | |
WECHAT_API_TIMEOUT | API 超时毫秒数,默认 15000 |
前置条件
- 公众号 AppID/AppSecret:mp.weixin.qq.com → 开发 → 基本配置
- IP 白名单:将你的出口 IP 添加到公众号后台 → 开发 → 基本配置 → IP 白名单
客户端配置
Claude Code
在 ~/.claude/mcp.json 或项目下 .claude/mcp.json 中添加:
{
"mcpServers": {
"wechat-writer": {
"command": "npx",
"args": ["wechat-writer-mcp"],
"env": {
"WECHAT_APP_ID": "your_app_id",
"WECHAT_APP_SECRET": "your_app_secret"
}
}
}
}
Cursor
在 Cursor Settings → MCP 中添加,配置同上。
Claude Desktop
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"wechat-writer": {
"command": "npx",
"args": ["wechat-writer-mcp"],
"env": {
"WECHAT_APP_ID": "your_app_id",
"WECHAT_APP_SECRET": "your_app_secret"
}
}
}
}
⚠️ 注意事项
- 安全:AppSecret 永远不要提交到 Git,
.env已在.gitignore中 - 权限:只调用
draft/add,永远不调用freepublish/submit或mass/send - 查重:
estimate_originality只与你自己的历史草稿比对,不能替代微信官方查重 - 封面:默认从
~/Pictures/wechat-covers/随机选取,无封面时自动生成占位图 - 模板:可自定义
templates/wechat-header.html和templates/wechat-footer.html
🗺️ Roadmap
- v0.1 - MVP:4 个核心 tool + 公众号草稿箱 API
- 自定义排版主题
- 封面图片 AI 推荐
- 掘金同步发布(v2)
- 发布后数据反馈
- 多标题 A/B 建议
🤝 贡献
欢迎提 Issue 和 PR。
git clone https://github.com/datoushiwo/wechat-writer-mcp.git
cd wechat-writer-mcp
npm install
npm run dev # 开发模式
📄 License
MIT
让 AI 帮你搞定公众号排版,你只管写内容。 ✍️
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.