xiumi-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@xiumi-mcp Start a fresh WeChat article and build a campus sports layout with a template."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
xiumi-mcp
让 AI Agent 直接操作秀米图文编辑器做公众号排版的 MCP 服务。
它用一个专属浏览器(持久化登录态)打开秀米编辑器,通过编辑器自身的 AngularJS 数据模型和官方接口完成排版工作,而不是模拟鼠标一条条拖组件。

能做什么
检索秀米模板库:分类、关键词、风格标签(体育 / 校园 / 简约 …)
把模板插入文章,返回组件 ID、文本槽和图片槽
按槽位替换模板文字(保留原设计与样式)
换图:本地文件或网络图片 → 自动上传秀米图床 → 写入图片槽
批量调整排版:字号、行距、字距、文字颜色
删除误插组件
设置文章标题与微信分享摘要
导出公众号可直接粘贴的最终 HTML
保存到秀米账号
Related MCP server: mcp-server-wechat-mp
环境要求
Node.js ≥ 22.18(直接运行 TypeScript,无需编译)
本机安装 Edge 或 Chrome(默认用 Edge)
一个秀米账号(首次使用扫码或密码登录)
安装与运行
npm install
node src/index.ts作为 MCP 客户端(stdio)配置:
{
"mcpServers": {
"xiumi": {
"command": "node",
"args": ["/absolute/path/to/xiumi-mcp/src/index.ts"],
"cwd": "/absolute/path/to/xiumi-mcp"
}
}
}Windows 示例(注意双反斜杠):
{
"mcpServers": {
"xiumi": {
"command": "C:\\Program Files\\nodejs\\node.exe",
"args": ["C:\\path\\to\\xiumi-mcp\\src\\index.ts"],
"cwd": "C:\\path\\to\\xiumi-mcp"
}
}
}可选环境变量:
变量 | 默认值 | 说明 |
|
| 浏览器用户数据目录(保存登录态) |
|
| 浏览器 DevTools 端口 |
|
| 连接已存在的浏览器 |
|
| 设为 |
| 自动探测 | 指定 Edge/Chrome 可执行文件 |
工具(16 个)
工具 | 作用 |
| 启动浏览器并打开编辑器; |
| 登录状态、文章 ID、标题、组件数、正文预览 |
| 打开登录页并截图,等待扫码/密码登录 |
| 按文章 ID 打开已保存的图文 |
| 模板一级分类与子分类 ID |
| 按关键词/分类/风格标签检索模板 |
| 插入模板到文末,返回组件 ID、文本槽、图片槽 |
| 替换组件内第 N 个文本槽的文字 |
| 替换第 N 个图片槽(本地文件或 URL) |
| 删除指定组件 |
| 批量调整正文/全部文本的字号、行距、字距、颜色 |
| 设置文章标题与微信分享摘要 |
| 查看文章顶层组件与槽位数量 |
| 导出公众号可用的最终 HTML(可写入文件) |
| 保存到秀米账号 |
| 截取文章画布 PNG |
推荐工作流
xiumi_start { fresh: true }xiumi_login(仅首次或登录过期)xiumi_search_templates { tagIds: [3227], query: "引导关注" }对每个模板:
xiumi_insert_template { templateId }→ 读返回的compIds/compsxiumi_fill_text填字;有图片槽时xiumi_set_image换图xiumi_set_typography统一字号/行距/字距xiumi_set_meta设标题与摘要xiumi_screenshot检查效果xiumi_get_html取最终 HTML(剪贴板里也会有一份,可直接粘进公众号编辑器)需要留档时
xiumi_save
效果示例
组件组合排版(小雪) | 整套商店模板(运动会) |
|
|
原理(逆向记录)
编辑器是 AngularJS SPA(
xiumi.us/studio/v5)+ UEditor 内核,正文是tn-cell组件树。模板列表接口:
GET https://xiumi.us/api/templates?tag_category=paper-cp&template_category=paper-cp&match_level=default&sort=DESC&limit=20&page=0&q=关键词&tag_ids=分类ID。关键词检索需要登录;未登录只能按分类浏览。
插入模板:调用模板面板 scope 上的
tplLib.onTemplateClicked(event, template),等同于点击模板卡片。填字:直接改 Angular scope 上的
cell.text,再$apply()同步视图,比模拟双击输入更稳。换图:把图片以 multipart 传到
POST /api/assets/image/file(字段image_file),拿到img.xiumi.us地址后写图片 cell 的cell.src。排版:文字 cell 的
style上有fontSize(百分比)、lineHeight、letterSpacing、color,改模型后$apply()。导出:点「导出 → 继续用复制粘贴」,秀米会把最终内联样式 HTML 写入剪贴板,用
navigator.clipboard.read()取回。保存:
onBtnClickSave(),需要登录且受账号等级限制。新开图文时可能弹「检测到未保存草稿,是否恢复」,自动化里默认点「取消」。
限制
「导入 HTML 代码」入口需要 VIP,本服务没有依赖它。
关键词搜索、保存、同步公众号都需要登录;部分模板/主题是会员专享。
字体家族(黑体/宋体)是秀米的全局「默认字体」,暂未封装;目前只支持字号、行距、字距、颜色。
没有「移动组件位置」的工具,只能删除后重新插入来调整顺序。
秀米前端改版可能影响选择器,遇到问题先跑
xiumi_status确认编辑器结构。商店整篇模板的「另存给自己」目前在 UI 中完成,尚未封装成工具。
故障排查
浏览器启动超时:关闭残留的 xiumi-mcp 浏览器窗口(任务管理器里带
xiumi-mcp用户目录的msedge.exe)后重试。导出返回空 HTML:确保浏览器窗口在前台;
xiumi_get_html依赖剪贴板读取权限。保存提示「登录以后才可以保存图文」:先
xiumi_login。在受限沙箱里运行:Chromium 依赖命名管道启动子进程,沙箱可能直接拒绝;请以普通权限运行本服务。
目录结构
src/
index.ts # MCP 服务、工具定义
xiumi.ts # 秀米页面操作(模板、填字、换图、排版、导出、保存、删除)
browser.ts # 浏览器启动、CDP 连接、登录态复用
config.ts # 路径、端口、环境变量
globals.d.ts # 页面内注入的全局类型(angular / UE)
test/
smoke.mjs # CI 冒烟测试:启动服务并校验 16 个工具注册
.github/workflows/ci.yml # Node 22/24 类型检查 + 冒烟
integrations/dsh/ # DeepSeek Harness 配置型 bundle(可选)
docs/ # 截图开发与测试
npm run typecheck # tsc --noEmit
npm run smoke # 启动 MCP 服务,校验工具注册(不需要浏览器)CI 在 Node 22.x / 24.x 上跑同样的两步,见 .github/workflows/ci.yml。
免责声明
本项目通过浏览器自动化操作用户自己的秀米账号,仅用于个人排版效率工具。请在遵守秀米服务条款的前提下使用;因使用本工具产生的账号风险、内容版权或平台规则问题由使用者自行承担。
License
Available Tools
16 toolsxiumi_delete_comp删除组件A
删除文章里的一个顶层组件(按组件 ID)。适用于删除误插入的模板或多余的空行/分割线。
Inputs: compId (required).
xiumi_fill_text填充文本槽A
把某个组件内第 slotIndex 个文本槽替换为指定文字(支持 \n 换行)。文本槽编号从 0 开始,顺序与组件内可见文字一致。
Inputs: text (required), compId (required), slotIndex (required).
xiumi_get_comps查看文章结构A
列出当前文章的顶层组件(ID、文字预览、文本槽数量),用于检查排版顺序和确认要填字的组件。
Inputs: no named parameters.
xiumi_get_html导出公众号 HTMLA
通过秀米「导出 → 继续用复制粘贴」把当前文章导出为公众号可用的最终 HTML(内联样式)。设置 saveToFile 时写入文件并只返回路径和长度,避免长文占用上下文。
Inputs: saveToFile.
xiumi_insert_template插入秀米模板A
把模板插入当前文章(追加到末尾),返回新增组件的 ID、文本槽和图片槽。插入后可用 xiumi_fill_text 填字、xiumi_set_image 换图。
Inputs: templateId (required), at.
xiumi_list_template_tags列出模板分类A
列出秀米图文模板的一级分类(标题、卡片、图片、布局、SVG、组件等)及其子分类 ID,可配合 xiumi_search_templates 的 tagIds 使用。
Inputs: no named parameters.
xiumi_login登录秀米A
打开秀米登录页并返回截图。请在弹出的浏览器窗口里用微信扫码或账号密码完成登录;等待 waitSeconds 秒后返回是否登录成功。
Inputs: waitSeconds.
xiumi_open_article打开已有图文A
按文章 ID 打开已保存的秀米图文(ID 来自 xiumi_save 返回的 URL 或 xiumi_status)。
Inputs: articleId (required).
xiumi_save保存到秀米A
保存当前图文到秀米账号(需登录)。返回是否成功及提示信息。
Inputs: no named parameters.
xiumi_screenshot截取文章画布A
截取当前文章画布并返回 PNG,用于检查排版效果。
Inputs: no named parameters.
xiumi_search_templates检索秀米模板A
按中文关键词和/或分类 ID 检索秀米模板库,返回模板 ID、标签、纯文本摘要。结果会缓存,可直接把模板 ID 交给 xiumi_insert_template。
Inputs: limit, query, pageNo, tagIds, +1 more.
xiumi_set_image替换/上传图片A
把组件内第 slotIndex 个图片槽替换成指定图片。支持本地文件(filePath)或网络图片(url);图片会先上传到秀米图床再写入排版。
Inputs: compId (required), url, filePath, slotIndex.
xiumi_set_meta设置标题与摘要B
设置当前图文的标题和微信分享摘要(摘要受秀米字数限制)。
Inputs: title, summary.
xiumi_set_typography调整字体排版A
批量调整正文(或全部文本)的字号、行距、字距和颜色,用于统一全文排版。scope=body 只改长段落,scope=all 改包括标题在内的所有文本槽。
Inputs: color, scope, minChars, lineHeight, +2 more.
xiumi_start启动秀米编辑器A
启动专用浏览器(持久化登录态)并打开秀米图文编辑器,返回登录状态与当前文章信息。首次使用、浏览器被关闭或需要新开空白图文时调用。
Inputs: fresh.
xiumi_status读取编辑器状态A
读取当前秀米编辑器状态:是否登录、文章 ID、标题、组件数、文本槽数量与正文预览。
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Most tools target a distinct resource+action: template search vs. tag listing, component insertion vs. deletion vs. inspection, and export vs. screenshot are clearly separable. The only friction points are the session cluster (start/login/open_article/status) and the mild overlap between xiumi_status and xiumi_get_comps, both of which report component information.
Every tool uses the same xiumi_ prefix with snake_case, giving a predictable namespace. Most follow verb_noun (search_templates, insert_template, fill_text, set_image, delete_comp, get_comps), but a few are bare or noun forms (xiumi_status, xiumi_save, xiumi_start, xiumi_screenshot, xiumi_login), a minor deviation.
16 tools is slightly heavy but each maps to a real step in the browser-automation workflow: session setup, template discovery/insertion, slot editing, typography, and export. No obviously redundant tool pads the count, though the seven session/output tools make the set feel large.
The lifecycle is well covered: launch/login/open/status/save/export/screenshot plus template browsing, insertion, text and image filling, deletion, component listing, typography, and metadata. Gaps remain for structural edits — no reordering/moving components, duplicating components, inserting a plain paragraph/divider, or undo — which agents may need for fine-grained layout repair.
Maintenance
Related MCP Connectors
Give your AI agents a design superpower. Generate, edit, and publish publication-grade decks, reports, landing pages, resumes, and marketing visuals directly within your agent workflow. Delivering frontier-level design quality at 3× the speed and 53× lower cost -from conversational prompt to live link or vector PDF in minutes.
Visual email & layout builder that turns AI assistants into a Temway authoring studio.
Agent-Native design tool - create and edit visual designs with agent assistance
Generate images, GIFs, videos, and PDFs from HTML, URLs, or templates — from your AI agent.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceBridges AI writing and content platforms by enabling AI agents to format Markdown and publish posts directly to WeChat Official Accounts with automatic image handling. It supports conversational theme management and streamlined drafting to eliminate the need for manual copy-pasting between editors.93 npm1,357Apache 2.0
- AlicenseAqualityFmaintenanceEnables AI agents to publish articles to WeChat Official Account (微信公众号). Supports image upload, draft creation, and publishing via standardized MCP protocol.51ISC
- AlicenseAqualityDmaintenanceEnables publishing HTML articles and image messages to WeChat Official Account drafts via LLM tool calls, with automatic image upload and URL replacement.51MIT
- AlicenseAqualityCmaintenanceEnables AI tools to preview and publish Markdown articles to WeChat Official Accounts, automatically converting content into WeChat-optimized HTML and handling cover images. Also lets users query publish status and read/like/comment statistics through natural language.51MIT

