xiumi-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| XIUMI_CDP_URL | No | Connect to an existing browser at this URL. | http://127.0.0.1:9333 |
| XIUMI_CDP_PORT | No | Browser DevTools (CDP) port. | 9333 |
| XIUMI_HEADLESS | No | Set to 1 to run headless (login/captcha will not work). | 0 |
| XIUMI_PROFILE_DIR | No | Browser user data directory (saves login state). | %LOCALAPPDATA%\xiumi-mcp\profile |
| XIUmi_BROWSER_PATH | No | Path to the Edge/Chrome executable; auto-detected by default. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
秀米(XIUMI)公众号图文排版工具。典型流程:xiumi_start → xiumi_search_templates 选模板 → xiumi_insert_template → xiumi_fill_text 填字 / xiumi_set_image 换图 → xiumi_set_meta 设标题/摘要 → xiumi_screenshot 检查 → xiumi_get_html 取最终 HTML(或 xiumi_save 存到秀米)。保存和同步需要先 xiumi_login 扫码登录。
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| xiumi_startA | 启动专用浏览器(持久化登录态)并打开秀米图文编辑器,返回登录状态与当前文章信息。首次使用、浏览器被关闭或需要新开空白图文时调用。 |
| xiumi_open_articleA | 按文章 ID 打开已保存的秀米图文(ID 来自 xiumi_save 返回的 URL 或 xiumi_status)。 |
| xiumi_statusA | 读取当前秀米编辑器状态:是否登录、文章 ID、标题、组件数、文本槽数量与正文预览。 |
| xiumi_loginA | 打开秀米登录页并返回截图。请在弹出的浏览器窗口里用微信扫码或账号密码完成登录;等待 waitSeconds 秒后返回是否登录成功。 |
| xiumi_list_template_tagsA | 列出秀米图文模板的一级分类(标题、卡片、图片、布局、SVG、组件等)及其子分类 ID,可配合 xiumi_search_templates 的 tagIds 使用。 |
| xiumi_search_templatesA | 按中文关键词和/或分类 ID 检索秀米模板库,返回模板 ID、标签、纯文本摘要。结果会缓存,可直接把模板 ID 交给 xiumi_insert_template。 |
| xiumi_insert_templateA | 把模板插入当前文章(追加到末尾),返回新增组件的 ID、文本槽和图片槽。插入后可用 xiumi_fill_text 填字、xiumi_set_image 换图。 |
| xiumi_fill_textA | 把某个组件内第 slotIndex 个文本槽替换为指定文字(支持 \n 换行)。文本槽编号从 0 开始,顺序与组件内可见文字一致。 |
| xiumi_delete_compA | 删除文章里的一个顶层组件(按组件 ID)。适用于删除误插入的模板或多余的空行/分割线。 |
| xiumi_set_imageA | 把组件内第 slotIndex 个图片槽替换成指定图片。支持本地文件(filePath)或网络图片(url);图片会先上传到秀米图床再写入排版。 |
| xiumi_set_typographyA | 批量调整正文(或全部文本)的字号、行距、字距和颜色,用于统一全文排版。scope=body 只改长段落,scope=all 改包括标题在内的所有文本槽。 |
| xiumi_set_metaB | 设置当前图文的标题和微信分享摘要(摘要受秀米字数限制)。 |
| xiumi_get_compsA | 列出当前文章的顶层组件(ID、文字预览、文本槽数量),用于检查排版顺序和确认要填字的组件。 |
| xiumi_get_htmlA | 通过秀米「导出 → 继续用复制粘贴」把当前文章导出为公众号可用的最终 HTML(内联样式)。设置 saveToFile 时写入文件并只返回路径和长度,避免长文占用上下文。 |
| xiumi_saveA | 保存当前图文到秀米账号(需登录)。返回是否成功及提示信息。 |
| xiumi_screenshotA | 截取当前文章画布并返回 PNG,用于检查排版效果。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.