io.github.datoushiwo/wechat-writer-mcp

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

📦 工具列表

💡 使用流程

用户: 导入 ./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

前置条件

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

• [x] 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 帮你搞定公众号排版，你只管写内容。 ✍️