Skip to main content
Glama
wechat-mcp-publisher

wechat-mcp-publisher

by weinh

wechat-mcp-publisher

微信公众号草稿发布本地 MCP 工具。把「写好的 HTML → 公众号草稿箱」变成一次 LLM 工具调用:图片上传、正文内嵌图换微信 URL、封面素材、建草稿全部自动完成。

基于官方 mcp SDK(2.x MCPServer),stdio 传输,单账号,uv 管理依赖。

工具面(5 个)

工具

用途

create_news_draft

图文草稿:吃 HTML(或 .html 文件路径)+ 封面图 + 必填摘要;标题 ≤64 字、摘要 ≤120 字;内嵌 <img> 自动上传换微信 URL

create_newspic_draft

图片消息草稿:必填文字说明(≤1000 字,HTML 标记自动清洗为纯文本)+ 1~20 张图(按序);标题 ≤20 字

list_drafts

分页查草稿箱

get_draft

草稿详情(含正文)

delete_draft

删除草稿(不连带删素材)

access_token 由内部获取、缓存、失效自愈(stable_token + 40001/42001 自动刷新重试一次),不暴露为工具。错误统一转为带处置提示的中文信息(如 40164 提示加 IP 白名单、53402 提示换正常尺寸图片),且不含凭据。

Related MCP server: WeChat Official Account MCP Server

默认值三层覆盖(留言开关 / 作者)

两个创建工具都支持 need_open_comment(开启留言)、only_fans_can_comment(仅粉丝可评论),图文工具另支持 author(作者名),按同一三层优先级解析:

工具入参 > .env 变量 > 内置默认

内置默认:开启留言、不限制仅粉丝、作者留空。想改写默认值,在 .env 里配置:

WECHAT_NEED_OPEN_COMMENT=0      # 整个账号默认关闭留言,个别文章仍可传参开启
WECHAT_AUTHOR=公众号编辑         # 图文默认作者名(图片消息无作者字段)

留言开关接受 1/0/true/false;作者名传空字符串入参可显式清空 .env 配置的默认值。

安装

uv sync
cp .env.example .env   # 填入 WECHAT_APP_ID / WECHAT_APP_SECRET

凭据获取:mp.weixin.qq.com → 设置与开发 → 基本配置。同一页面需把本机公网 IP 加入 IP 白名单,否则 token 获取报 40164。

已发布 PyPI 后也可免克隆直接运行(在含 .env 的目录):

uvx wechat-mcp-publisher
# 或 pip install wechat-mcp-publisher && wechat-mcp-publisher

此时 MCP 客户端配置可简化为 "command": "uvx", "args": ["wechat-mcp-publisher"]。

接入 MCP 客户端

Claude Code(推荐,一条命令):

claude mcp add wechat-mcp-publisher -- uv run --directory /你的路径/wechat-mcp-publisher python -m wechat_mcp_publisher

项目级配置(本仓库已内置 .mcp.json,Claude Code 在本仓库目录打开即生效,首次需在 /mcp 中确认信任):无需手动添加。

Claude Desktop / 其他客户端:把 examples/mcp-client-config.example.json 中的片段合入对应配置文件。

使用示例

对 LLM 说:

帮我把 /path/article.html 发成公众号图文草稿,封面用 /path/cover.jpg

或图片消息:

把这三张图 /a.jpg /b.jpg /c.jpg 发成图片消息草稿,说明文字:周末出片

真实 API 链路演示见 examples/simple_usage.py(token → 上传 → 建草稿,兼作真机冒烟)。

测试

uv run pytest

全部接口经 responses mock,不需要真实账号即可跑通。

范围与已知限制

  • 不做 markdown→HTML 转换:正文入口是 HTML,转换请用你已有的 md→html 工具完成

  • 不做发布(freepublish):当前只到草稿;发布留给账号认证后扩展

  • 账号权限:个人未认证订阅号实测(2026-08)可正常调用素材/草稿接口、端到端建草稿;个别受限接口仍可能返回 48001(错误提示会说明)

  • 封面裁剪:图片消息(newspic)首图兼作封面,图片过小或比例异常会报 53402(1×1 实测失败、600×600 实测通过),请用正常尺寸图片

  • HTML 微信兼容性:微信编辑器只认内联样式的 HTML 子集,排版适配由上游转换工具负责,本工具不校验不修复

  • 素材堆积:删除草稿不会删除其占用的永久素材图片,长期使用需偶尔在公众号后台清理

  • 单账号:凭据来自 .env,不提供多账号切换

Available Tools

5 tools
create_news_draftA

创建图文草稿(news),成功返回 {"media_id": ..., "title": ..., "cover_url": ...}。

参数:
  title: 文章标题(必填)
  content: 正文。支持两种形态——HTML 字符串,或本地 .html 文件路径
           (若该路径存在则自动读取文件,否则按 HTML 内容处理)
  cover: 封面图片(必填):本地文件路径或 http(s) URL,自动上传为封面素材
  author: 作者名(可选)
  digest: 摘要(可选,留空时微信自动截取正文)
  content_source_url: 原文链接(可选)

正文 HTML 中的 <img> 会自动上传到微信并替换 src 为微信托管的 URL;
已指向微信域名(mmbiz.qpic.cn / mp.weixin.qq.com)的图片保持不变。

Inputs: cover (required), title (required), content (required), author, +2 more. Returns: object

create_newspic_draftA

创建图片消息草稿(newspic),成功返回 {"media_id": ..., "title": ..., "image_count": ...}。

参数:
  title: 消息标题(必填)
  images: 1~20 张图片,按传入顺序展示;每项为本地文件路径或 http(s) URL
  content: 图片下方的纯文字说明(可选,注意不是 HTML)

与图文消息不同:图片消息的 content 是纯文本,图片本体在 images 中,
全部经永久素材接口上传后按序组装。

Inputs: title (required), images (required), content. Returns: object

delete_draftA

删除指定草稿,成功返回 {"media_id": ..., "deleted": true}。

注意:删除草稿不会连带删除其占用的永久素材图片(微信行为)。
参数:
  media_id: 草稿 ID

Inputs: media_id (required). Returns: object

get_draftA

查询草稿详情(含 news_item 全部字段:标题、正文 HTML、封面等)。

参数:
  media_id: 草稿 ID(由 create_news_draft / create_newspic_draft 返回,或从 list_drafts 获取)

Inputs: media_id (required). Returns: object

list_draftsA

分页查询草稿箱列表,返回 {"total": 总数, "offset": 当前偏移, "items": [{media_id, title, update_time}]}。

参数:
  offset: 起始位置(默认 0)
  count: 每页数量(默认 20,最大 20)

Inputs: count, offset. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 5 tools

    Disambiguation5/5

    The two create tools are clearly separated by draft type (newspic vs news) with distinct parameter semantics, while list, get, and delete have unambiguous scopes. No two tools appear to overlap in purpose.

    Naming Consistency4/5

    Most tools follow a verb_noun snake_case pattern such as list_drafts, get_draft, and delete_draft. The create tools also align with verb+type+draft, though 'newspic' vs 'news' is a slightly non-parallel naming choice.

    Tool Count5/5

    Five tools is well-scoped for a draft-management server: two creation variants plus standard list, get, and delete operations. Each tool earns its place without unnecessary overlap or bloat.

    Completeness3/5

    The set covers create, read/list, and delete for drafts, but lacks an update_draft operation, forcing agents to delete and recreate to modify content. Additionally, despite the 'publisher' name, there is no publish/send tool, leaving a notable gap in the apparent domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers