mcpField
W
wechat-writer-mcp

wechat-writer-mcp

Local
github.com/datoushiwoSocial Media0Updated 14w ago

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

  1. 01Import Markdown files or webpage URLs
  2. 02Format content as WeChat-ready HTML
  3. 03Generate title and summary suggestions
  4. 04Compare against past drafts for originality
  5. 05Save content to the WeChat draft box
  6. 06Never publish or send automatically

Use cases

  1. 01Convert a Markdown article into a WeChat draft
  2. 02Format code blocks and add templates
  3. 03Review similarity to previous drafts
  4. 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.

mcp.json · Universal config
{
"mcpServers": {
"datoushiwo-wechat-writer": {
"command": "npx",
"args": [
"-y",
"wechat-writer-mcp"
],
"env": {
"WECHAT_APP_ID": "<WECHAT_APP_ID>",
"WECHAT_APP_SECRET": "<WECHAT_APP_SECRET>",
"WECHAT_COVERS_DIR": "<WECHAT_COVERS_DIR>",
"WECHAT_DEFAULT_AUTHOR": "<WECHAT_DEFAULT_AUTHOR>",
"WECHAT_API_TIMEOUT": "<WECHAT_API_TIMEOUT>"
}
}
}
}
Run commandnpx -y wechat-writer-mcp
Environment variables to set
WECHAT_APP_ID微信公众号 AppID(mp.weixin.qq.com → 开发 → 基本配置)
WECHAT_APP_SECRETSecret微信公众号 AppSecret(mp.weixin.qq.com → 开发 → 基本配置)
WECHAT_COVERS_DIR封面图片目录,默认 ~/Pictures/wechat-covers
WECHAT_DEFAULT_AUTHORSecret草稿默认作者名
WECHAT_API_TIMEOUT微信 API 超时毫秒数,默认 15000

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmwechat-writer-mcp0.1.1

Tools

4

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
urlstringNoWebpage URL (required when source_type=url)
pathstringNoLocal file path (required when source_type=file)
source_typeenumYesSource type: file reads a local file; url fetches the main text of a webpagefile | url

Details

From the project README

wechat-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 文件或网页 URLraw_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_TIMEOUTAPI 超时毫秒数,默认 15000
前置条件
  1. 公众号 AppID/AppSecret:mp.weixin.qq.com → 开发 → 基本配置
  2. 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

Markdown supported

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.