Wechat Writer Mcp

io.github.datoushiwoPublished by GitHub account datoushiwov0.1.1Updated Oct 24, 2026

面向技术博主的 AI 内容加工流水线 MCP —— 从原始素材到公众号草稿箱

VerifiedSTDIODesktop onlyProductivity & WorkflowMedia & Design

Overview

AI-generated overview

A local MCP server that turns raw markdown or web sources into formatted WeChat Official Account drafts, saving them to the draft box only.

What you can do
Import source material from a local markdown file or a web URL, returning markdown plus title and word-count metadata. Reformat markdown for WeChat, producing adapted HTML, three title candidates and a summary suggestion. Estimate originality by scoring the article and comparing it with your own past drafts. Save the finished title and HTML into the WeChat draft box and return a media ID and backend link.
When to use it
Useful for technical bloggers who write in markdown and want an assistant to handle WeChat formatting, title options and draft creation. It suits a review-then-publish workflow where you finish and send the post manually in the WeChat backend.
Requirements
Runs locally via npx or a local npm install, so Node.js is needed. Requires a WeChat Official Account AppID and AppSecret (WECHAT_APP_ID, WECHAT_APP_SECRET), plus adding your outbound IP to the account's IP whitelist. Optional settings cover cover-image directory, default author and API timeout.
Before you install
The AppSecret is a sensitive credential; keep it out of Git and configuration files you share. The server writes to your WeChat account's draft box, so review drafts before sending. Originality scoring only compares against your own historical drafts and does not replace WeChat's official duplicate check. Importing a web URL sends that request to the third-party site.

Installation

In SourceWeft

  1. Open Wechat Writer Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

wechat-writer-mcp

面向技术博主的 AI 内容加工流水线 MCP —— 从原始素材到公众号草稿箱,只存草稿,不自动发布。

⚡ 快速开始

一键启动

bash
npx wechat-writer-mcp

MCP 配置

json
{  "mcpServers": {    "wechat-writer": {      "command": "npx",      "args": ["wechat-writer-mcp"],      "env": {        "WECHAT_APP_ID": "your_app_id",        "WECHAT_APP_SECRET": "your_app_secret"      }    }  }}

立即体验

text
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.mdAI:   [调 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 直接运行(推荐)

bash
npx wechat-writer-mcp

方式二:本地安装

bash
git clone https://github.com/datoushiwo/wechat-writer-mcp.gitcd wechat-writer-mcpnpm installnpm run build

环境变量

bash
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 中添加:

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:

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。

bash
git clone https://github.com/datoushiwo/wechat-writer-mcp.gitcd wechat-writer-mcpnpm installnpm run dev  # 开发模式

📄 License

MIT


让 AI 帮你搞定公众号排版,你只管写内容。 ✍️

Source: README.md at commit 829c7cc

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts