1. 为什么要在 Cursor 里让 AI 直接操控 WPS先说清楚这套方案到底在解决什么问题。平时我们用 AI 写文档流程基本是让模型生成一段文字复制切到 WPS粘贴再手动调格式。表格更麻烦AI 给你一段 Markdown 表格你还得自己往单元格里填。整个过程 AI 只负责「想」动手的活还是人干。Cursor MCP 配置 AI 操控 WPS 这套玩法核心是把「动手」这一步也交给 AI。你在 Cursor 的 Agent 里说一句「帮我把当前文档加个一级标题正文改成微软雅黑 11 号、1.5 倍行距」它就直接去操作你已经打开的那个 WPS 窗口标题、字体、行距当场就变了。你眼睛看到的文档就是 AI 正在改的那一份。这里的关键角色是 MCPModel Context Protocol。你可以把它理解成 Cursor 和外部工具之间的一套「插座标准」。Cursor 本身不会操作 WPS但它能通过 MCP 协议去调用一个叫 wps-office-mcp 的本地服务这个服务再通过 Windows 的 PowerShell COM 通道去指挥当前打开的 WPS。整条链路是Cursor Agent → MCP 服务Node.js 进程→ PowerShell COM → WPS 加载项 → 你的文档。适合谁用三类人最合适。第一类是经常要批量做 Word 排版、Excel 数据整理、PPT 框架的办公族重复劳动多第二类是写报告、做周报月报的人格式要求固定但每次都要手动调第三类是想尝鲜 MCP 生态的开发者WPS 这套正好是个「看得见效果」的练手场景。和「用 Python 直接改 docx 文件」有什么区别Python 那种方式是在后台改磁盘上的文件docx 本质是个压缩包改起来快但复杂排版、图表、批注经常力不从心而且改完你得重新打开文件才看得到。MCP 这套是「真的在驱动你打开的 WPS」适合改格式、动图表、写批注这类必须在软件界面里完成的活。两者不冲突看场景选。下面从环境准备一路写到验证成功每一步都给可复制的命令和配置。踩过的坑我也会标出来尤其是那个让很多人卡住的 logger.ts 改动。2. 前置准备Node.js、WPS 与 wps-skills 项目获取动手之前先把环境对齐不然后面报错会很难定位。这一节把需要装的东西、版本要求、项目怎么拿一次讲清楚。2.1 环境要求清单WPS Office 已安装个人版或专业版都行标准是能正常打开文字、表格、演示三种文档。WPS 装在 C 盘还是 E 盘不影响加载项和 MCP 主要依赖当前用户的 AppData 目录。Node.js 版本要 ≥ 18推荐用 LTS。我实测时用的是 v24没问题。装完在终端敲一句验证node -v能打印出版本号就对了。如果提示node 不是内部或外部命令说明 Node 没进 PATH重装时勾选「Add to PATH」或者手动把 Node 安装目录加进环境变量。Git 用于克隆仓库。没有 Git 也行直接去 GitHub 下载 ZIP 解压效果一样。Cursor 要已安装并且你有权限编辑它的用户级 MCP 配置。2.2 获取 wps-skills 源码把仓库克隆到一个固定目录路径自己定。下面以C:\Users\用户名\Desktop\WPS\wps-skills-main为例cd C:\Users\用户名\Desktop\WPS git clone https://github.com/lc2panda/wps-skills.git如果你是从 GitHub 下载 ZIP 解压的文件夹名可能是wps-skills-main。后文里凡是出现「项目根目录」你都替换成自己的实际路径。克隆完进项目根目录看一眼应该能看到这几个文件夹wps-office-mcp、wps-claude-addon、scripts、skills。wps-office-mcp是 MCP 服务端wps-claude-addon是 WPS 加载项scripts里有一键安装脚本。结构对不上说明下载不完整重新拉一次。2.3 这套方案的三层结构理解结构能帮你排错。整套东西是三层叠起来的第一层Cursor 里的「遥控器」——wps-office-mcp用 Node 跑。Cursor 通过它把你说的话变成一条条指令每条指令对应一个wps_开头的工具比如改单元格、插段落、调格式。第二层WPS 里的「接收器」——加载项文件夹名一般是wps-claude-addon。装好后 WPS 顶部会出现「Claude 助手」选项卡它负责跟已经打开的 WPS 打交道不是另起一个假 Word。第三层Windows 上的「传话通道」——PowerShell COM。Cursor 不直接摸你的文档文件而是让系统去跟「当前这个 WPS 窗口」说话就像以前用宏、用脚本控制 Office 一样只是现在换成了 AI 在点。三层任何一层断了工具调用都会失败。后面排错时先判断是哪一层的问题能省很多时间。3. 可复制配置一键安装脚本与 Cursor MCP 注册这一节是全文的核心操作区给的都是能直接复制的片段。分两步先在项目里跑一键安装脚本再手动往 Cursor 里注册 MCP。3.1 一键安装脚本在项目根目录执行cd 你的项目根目录 powershell -ExecutionPolicy Bypass -File .\scripts\auto-install.ps1这个脚本大致会做四件事检查 Node.js 版本在wps-office-mcp里执行npm install和npm run build向%USERPROFILE%\.claude\settings.json写入wps-officeMCP 配置主要供 Claude Code 用把加载项复制到 WPS 的 jsaddons 目录并维护publish.xml。成功时末尾会出现Installation Complete。如果卡在某一步看下面的常见问题。踩坑点jsaddons 目录不存在。脚本在第 5 步会往%APPDATA%\kingsoft\wps\jsaddons复制加载项。如果这个目录还没被创建脚本会报错[ERR] WPS add-on directory not found: C:\Users\...\AppData\Roaming\kingsoft\wps\jsaddons原因是 WPS 虽然装了、也用过但有时不会自动创建jsaddons文件夹。这跟 WPS 装在哪个盘无关用户级加载项始终落在当前用户的Roaming\kingsoft\wps\下。手动建一下再跑脚本New-Item -ItemType Directory -Path $env:APPDATA\kingsoft\wps\jsaddons -Force3.2 在 Cursor 中注册 MCP注意auto-install.ps1不会修改 Cursor这一步必须手动做。打开 Cursor 的用户级 MCP 配置文件在mcpServers里加一项。路径改成你自己的dist\index.js绝对路径{ mcpServers: { wps-office: { command: node, args: [C:\\Users\\你的用户名\\Desktop\\WPS\\wps-skills-main\\wps-office-mcp\\dist\\index.js] } } }如果文件里已经有其他 MCP只需在mcpServers里追加wps-office: { ... }。注意上一项末尾要加英文逗号保持 JSON 合法否则整个配置会解析失败。关于 command 用 node 还是绝对路径。如果 Cursor 启动子进程时找不到nodePATH 不完整把command改成node.exe的绝对路径command: C:\\Program Files\\nodejs\\node.exe保存后完全重启 Cursor在「设置 → MCP」里确认wps-office已连接。这里三件套要齐全Base URL 指向本地 MCP 服务、Key 由 MCP 进程内部管理、Model ID 在 Cursor 侧选择。MCP 这套不像 HTTP API 那样显式填 Key但概念上是一样的——Cursor 通过配置找到服务服务再对接模型。3.3 改一处代码让 Cursor 能连上这一步是很多人卡住的地方。默认的 logger 配置会把日志写到 stdout而 MCP 协议要求 stdout 只传协议数据日志必须走 stderr否则 Cursor 会报连接错误。用 Cursor 或任意编辑器打开这个文件项目根目录\wps-office-mcp\src\utils\logger.ts按CtrlF搜索transports你会看到transports: [下面排着几段new winston.transports....。找到第一块控制台输出有两种写法写法 A需要改里面是new winston.transports.Console({。 写法 B已经改好里面是new winston.transports.Stream({且下一行有stream: process.stderr。如果是写法 B跳过改动直接编译。如果是写法 A选中并删除从new winston.transports.Console({开始到与它成对的}),为止的整段注意包含最后的逗号后面往往还有 File 之类的配置别删错。在原位置粘贴// 控制台日志固定写到 process.stderr new winston.transports.Stream({ stream: process.stderr, format: winston.format.combine( winston.format.colorize({ all: true }), winston.format.timestamp({ format: YYYY-MM-DD HH:mm:ss }), wangFormat ), }),保存后重新编译否则 Cursor 还在用旧的distcd 项目根目录\wps-office-mcp npm run build看到没有报错、命令结束即可。确认生成了项目根目录\wps-office-mcp\dist\utils\logger.js。然后完全退出 Cursor不是只关窗口尽量从托盘也退出再打开看wps-office是否不再报错。如果npm run build报错先在wps-office-mcp目录下执行npm install再npm run build。仍失败就把完整英文报错复制下来去项目 GitHub 的 Issues 里搜。4. 验证请求让 AI 真的操控 WPS 文档配置完不算成功得实际跑一遍确认链路通了。这一节给自检清单和三类文档的验证指令。4.1 安装后自检清单先做静态检查四项都对上再联调文件存在项目根目录\wps-office-mcp\dist\index.js。 WPS完全退出后重新打开打开任意文字/表格/演示文档功能区出现「Claude 助手」或英文 Claude Assistant连接状态显示 PowerShell COM 桥接、初始化完成。 CursorMCP 列表中wps-office无红点可展开查看工具列表。 联调在 WPS 中保持目标文档打开且为当前窗口在 Cursor Agent 里发起自然语言指令允许调用wps-office工具。4.2 Word 文档验证先打开一个 WPS Word 文档然后在 Cursor Agent 里发指令。下面这条可以直接复制帮我完成当前 WPS Word 文档的初始化排版在文档开头插入一级标题「WPS-Skills 与 Cursor MCP 联动测试报告」字体微软雅黑、加粗、居中字号 24颜色深蓝标题下方加一条黑色细横线。横线下方插入三段正文内容分别是测试目的、测试目标、测试环境说明。所有正文统一微软雅黑、11 号、1.5 倍行距、首行缩进 2 字符段落加黑色上下边框第一段加灰色底纹和批注「MCP 工具自动生成」。发出去后观察 WPS 窗口标题、横线、正文格式应该逐项出现。如果只动了一部分说明部分工具调用成功检查是不是某条指令超出了加载项支持范围。4.3 Excel 表格验证打开一个 WPS 表格文档发这条操作当前 WPS 表格生成员工信息统计表。A1 到 E1 依次填员工编号、姓名、部门、岗位、月薪表头加粗、微软雅黑、12 号、浅蓝背景、居中。下方填 5 行模拟数据。然后在 E8 填「合计」、E9 填「平均工资」E8 自动算 E2:E6 月薪总和E9 算平均值E8:E9 加粗、红色、保留 2 位小数。最后给 A1:E9 加全边框。这条能验证单元格写入、格式设置、公式计算三类能力。公式那步如果没生效检查是不是把公式当成了纯文本写入。4.4 PPT 演示验证打开一个 WPS 演示文档发这条创建一个 PPT 框架主题「AI 赋能办公自动化」。第 1 页标题页主标题「AI 赋能办公自动化」副标题「未来工作方式的变革与机遇」。第 2 页目录页四个目录项行业趋势与挑战、核心技术解析、应用场景展示、未来发展展望。第 3 页内容页讲行业趋势。第 4 页图文页讲核心技术。第 5 页结束页居中大字「感谢观看」下方小字「QA」。统一标题字体思源黑体 Bold 32 号内容字体思源黑体 Regular 16 号。PPT 的验证重点是页面创建和主题应用如果页面出来了但字体没统一多半是字体名在系统里对不上换成系统已装的字体再试。5. 本篇常见错误排查配置过程中最容易撞上的几个报错这里对照真实现象给处理方向。先看速查表现象可能原因处理方向脚本报 jsaddons 不存在目录未创建手动建目录后重装Cursor MCP 红色 Errorstdout 被日志占用或 node 不在 PATH改 logger.tscommand 改用 node 绝对路径WPS 无「Claude 助手」选项卡加载项未复制或 publish.xml 未注册检查 wps-claude-addon 与 publish.xml重启 WPS工具调用无效果或返回空未打开对应类型文档打开文字/表格/演示并置于前台npm run build 失败依赖或 TypeScript 问题删 node_modules 与 dist 后重装依赖再编译5.1 401 与 local proxy failed如果你在 Cursor 里看到类似401 Unauthorized或local proxy failed的报错先分清是 MCP 层还是模型层。MCP 层的 401 通常是配置里的服务地址或凭据不对检查mcpServers里的路径是否指向真实存在的dist\index.js。local proxy failed多半是本地 MCP 进程没起来去 Cursor 的 MCP 面板看进程状态或者手动在终端跑一次node 项目根目录\wps-office-mcp\dist\index.js看有没有报错输出。5.2 reading choices 报错reading choices这类报错一般出现在模型返回结构不符合预期时。MCP 工具调用要求模型输出结构化的 tool call如果模型侧配置不对Cursor 解析不了就会报这个。检查 Cursor 里选的模型是否支持 function calling以及 MCP 工具列表是否正常加载。工具列表为空的话模型根本不知道有哪些工具可用。5.3 OAuth 相关报错MCP 服务本身不走 OAuth但如果你在 Cursor 里同时配了其他需要 OAuth 的 MCP可能会互相干扰。看到 OAuth 报错先确认是不是wps-office这一项引起的把其他 MCP 临时禁用单独测wps-office。确认是它的问题再回来查配置。5.4 工具调用返回空最常见的原因是没打开对应类型的文档。wps_工具是操作「当前活动窗口」的你没开 Word 文档却让它插段落自然返回空。另一个原因是文档没置于前台被其他窗口挡住了。操作前把目标文档点一下确保它是当前活动窗口。6. 长期使用建议与接入入口跑通之后这套配置可以长期用。几个实用建议把常用的排版指令存成 Cursor 的 prompt 片段下次直接调用WPS 加载项更新后可能需要重新复制到 jsaddons升级 WPS 后如果选项卡消失重跑一次安装脚本wps-office-mcp的源码改动后记得npm run build否则 Cursor 用的还是旧 dist。如果你想把模型调用也统一管理TaoToken 提供了模型对话、Coding Plan、API Keys 和接入文档几个入口按需取用想先试试模型对话效果https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite长期编码、跑 Agent 场景看 Coding Planhttps://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite管理密钥进控制台https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite创建和查看 API Keyshttps://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入文档https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteClaude Code 相关接入https://taotoken.net/api?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后给个最小命令备忘复制粘贴就能用# 1. 创建 jsaddons若不存在 New-Item -ItemType Directory -Path $env:APPDATA\kingsoft\wps\jsaddons -Force # 2. 进入项目根目录后一键安装 cd 项目根目录 powershell -ExecutionPolicy Bypass -File .\scripts\auto-install.ps1 # 3. 仅重新编译 MCP更新代码或改过源码后 cd 项目根目录\wps-office-mcp npm run build整套流程走下来最花时间的其实是 logger.ts 那处改动和 Cursor 的 MCP 注册其余都是一次性配置。配好之后日常办公里那些重复的排版、填表、做 PPT 框架的活就可以直接交给 Cursor 里的 Agent 去点了。