WPS Office 多面手 MCP

简体中文 | English

让 AI 直接操控你正开着的 WPS 文字、表格、演示。

它不只会改，也能从零生成。空白页起一份带目录和图表的文稿；把表格里的数字变成图表与透视表， 再贴进演示；整篇换字体、套主题；导出成图片和 PDF。

作者 / 维护者：赢容 · npm · Release

30 秒上手

npx -y wps-multitool-mcp

{
  "mcpServers": {
    "wps-multitool-mcp": {
      "command": "npx",
      "args": ["-y", "wps-multitool-mcp"]
    }
  }
}

重启客户端，打开一个 WPS 文档，然后直接说：

把这份合同的金额段落加粗，并在末尾补一段风险提示

更多例子：

• "把这张表做成柱状图，导出成图片"

• "整份 PPT 统一成思源黑体，每页加上页码"

• "给这篇论文生成目录和交叉引用"

想要侧边面板（快照 / 撤销 / 暂停 AI / 状态），再装加载项：

irm https://cdn.jsdelivr.net/gh/forkgo430/wps-multitool-mcp@main/scripts/install.ps1 | iex

在意安全？先把脚本下载下来用 Get-FileHash 和 Release 页公布的 SHA256 比对，再运行； 或把地址里的 @main 换成 @v1.0.3 锁定版本。

Related MCP server: Office-MCP

它能干什么

用起来省事的四个设计：

• 一句话定方向：wps_route_intent 把"帮我做个汇报"映射到演示组，认不出来它会明说

• 用中文搜工具：wps_search_tools 结果带 notFor 反例，近名工具靠它分

• 工具自带安全标签：全部工具都标明只读 / 会改动 / 可否重复执行（精确数字见下方统计）

• 改名不砸旧调用：旧名字自动解析到新工具，参数一并搬运

全部工具的完整清单（名称 / 是否需要确认 / 真机验证状态）见 TOOLS.md， 由注册表自动生成。旧名字调用会自动解析到新工具，参数一并搬运。

• 283 个工具（7 个内置 + 276 个专业/组工具）；默认只列 40 个（基础档 ∩ 真机验证，按需加载 —— 口径与校验见 scripts/manual/basic-tier-verify.js）

• 分布（按工具组，内置计入对应组）：通用 27（含 core）/ Word 67 / Excel 91 / PPT 98

• 注解（实测）：只读 51 / 破坏性 36 / 非幂等 111，覆盖 283/283

安装

irm https://cdn.jsdelivr.net/gh/forkgo430/wps-multitool-mcp@main/scripts/install.ps1 | iex

自动完成：检查环境 → 拉取项目 → 装依赖并编译 → 部署 WPS 加载项 → 安装 skill → 打印 MCP 配置。 装完重启 WPS 和客户端即可。需要能访问 GitHub；否则用下面的手动安装。

git clone https://github.com/forkgo430/wps-multitool-mcp.git
cd wps-multitool-mcp
powershell -ExecutionPolicy Bypass -File scripts/install.ps1

node wps-multitool-mcp/dist/index.js install

认这些客户端，各写各的原生格式：CodeBuddy / WorkBuddy / Codex CLI / Claude Code / Cursor， 另有 DeepSeek Harness 专用支持。只认已经装过的客户端；写配置前自动备份、写后回读校验、 失败自动还原。加 --dry-run 演练、--print 只打印不写盘。

它怎么工作

flowchart TB
    S["Skills 层<br/>探活 → 定组 → 加载组 → 选型 → 写前确认"]
    M["MCP Server<br/>stdio，默认 40 个基础工具"]
    B["常驻桥（Node）<br/>按应用拆子进程"]
    P["常驻 PowerShell<br/>excel / word / ppt / common"]
    C["COM 动作"]
    W["Ket / Kwps / Kwpp.Application"]

    S -->|MCP 协议| M
    M --> B --> P --> C --> W

冷启动约 5 秒；之后每次调用是桥转发的往返 2~3 毫秒（不含 WPS 实际执行的动作本身）。 一个应用一个进程：文字那边卡死了，表格照样干活。

写错也退得回去

AI 会犯错，所以每一层都按"它一定会犯错"来设计：

侧边面板

wps-multitool-addon/ 是一个装进 WPS 的任务窗格：侧边栏实时显示桥的状态， 外加 保存 / 撤销 / 导出 PDF / 建快照 / 解除卡死 五个动作按钮——注意它会真的改文档， 只读的只有状态查询接口。装不装面板都不影响 MCP，两者共用同一个桥。

在 DeepSeek Harness（dsh）里用

一条命令，工具和技能一起装上：

dsh plugin --profile <你的profile> add dsh-multitool

装上同时得到 40 个 WPS 工具和一份教 AI 正确使用顺序的技能，工具名前缀 mcp__wpslocal__*。

⚠️ 别装错包：npm 上另有一个 dsh-wps，那是金山文档云文档集成。本包操作的是 你电脑上正开着的 WPS 窗口，不联网、不需要 OAuth。两者可同时装。

隐私

• 文档内容不出本机：没有遥测、没有崩溃上报、没有使用统计，src/ 里没有任何出站请求

• 唯一的本地网络端点是桥的只读状态接口（127.0.0.1:27731/status，只给 WPS 任务窗格轮询）

• 快照按文档留在 ~/.wps-multitool-mcp/snapshots/，等同文档副本；处理完敏感文档建议清空

完整威胁模型见 SECURITY.md。

已知限制

• 仅 Windows：WPS 的 COM 自动化只在 Windows 可用（Linux 版在建设中，见下方路线）

• 需要 WPS 正开着：它操控的是"活文档"，不是文件转换器

• COM 写入不是事务：改错了没有 Ctrl+Z——这正是默认快照存在的原因

• 默认 40 个工具：其余按组加载，防止几百个工具塞满 AI 的上下文

• 部分工具尚未在真机验证过（清单里标注 static），用后请如实告知用户

故障排除

路线

• Linux / macOS：平台自动识别与加载项通道骨架已落地，WPS JSAPI 全量覆盖率已实测 （296 动作：支持 199 / 可适配 45+），动作层已实现 123/296（B4+B5 三批，mock 全绿； 真机补测 B3.7 待环境）。

• 多应用批量与自动化检查持续加细；欢迎 提 issue 点名你最想要的场景。

许可

MIT