Charles Zhang

Posted on Sep 6 Originally published at Medium

打造属于自己的 WPS AI Agent：个人开发者 MCP 接入完全指南

#wps #agents #mcp #skills

让 Claude、Cursor 直接操控你的 Word、Excel 和 PPT

每当聊到 AI 办公，我们总会遇到同一个痛点：AI 能说会道，但就是“动不了手”。

它可以给你写出周报的文案，但你得自己复制到 Word 里调格式；它可以给出数据分析的结论，但你得手动打开 Excel 去敲公式。

2026 年，随着 MCP（模型上下文协议） 的爆火，这个僵局终于被打破了。金山办公（WPS）全面拥抱了这一协议，而作为个人开发者，我们现在有能力给 Claude 或 Cursor 安上一双“WPS 的手”。

今天，我将带你从零配置 MCP Server，让你的 AI Agent 不仅能“想”，还能直接“写”进 WPS 文档里。

为什么是 MCP？它不只是个 API

MCP 由 Anthropic 提出，被誉为 AI 世界的 “USB-C 接口” 。在此之前，每个 AI 工具连接外部数据都需要写一套独立的插件，极其繁琐。MCP 统一了标准——任何支持 MCP 的客户端（如 Claude Code、Cursor），都能无缝调用任何兼容 MCP 的服务。

对于 WPS 而言，这意味着质的飞跃：

从“复制粘贴”到“直接写入”：AI 可以直接修改你电脑上正在打开的 WPS 窗口。
从“建议”到“执行”：AI 不仅能告诉你公式怎么写，还能直接填进单元格里。

目前，WPS 365 开放平台已原生兼容 MCP 协议，而社区的开源方案更是让个人开发者能立刻上手，当然，首先需要去 WPS官网下载并安装 WPS 软件。

三大主流方案对比：我该选哪个？

目前 GitHub 上有三个极具代表性的开源项目，在开始动手前，你需要选一个“指挥官”。

方案名称	核心特点	工具数量	适用场景
wps-skills (最推荐)	跨平台，Node.js 驱动，功能覆盖最全	243 个 (Excel 82/PPT 112)	追求全能，希望在所有 AI 工具中通用
wps-mcp-server	Python 轻量级，基于 COM 接口	约 11 个核心工具	Windows 用户，熟悉 Python，偏好简洁
wps-editor-mcp	双模式 (File 解析 + COM 控制)	中等，含格式转换	需要做 Word 转 PPT、无 Office 环境解析

个人建议：如果是第一次尝试，请闭眼选 wps-skills。它拥有最活跃的社区和最多的工具覆盖，且同时支持 Mac、Win 和 Linux。

实战手记：配置 wps-skills 全流程

下面我们以 wps-skills 为例，完整走一遍配置流程。你会发现，让 AI 拥有“手脚”只需要 4 步。

Step 1：环境与拉取

确保你已安装 Node.js >= 18.0.0 和 WPS Office。

git clone https://github.com/lc2panda/wps-skills.git
cd wps-skills
cd wps-office-mcp
npm install
npm run build
cd ..

Step 2：为你的 AI 工具写入配置

这里的关键是 绝对路径。以下以 Cursor 和 Claude Code 为例：

Cursor：在项目根目录创建 .cursor/mcp.json：

{
  "mcpServers": {
    "wps-office": {
      "command": "node",
      "args": ["/Users/你的用户名/项目路径/wps-skills/wps-office-mcp/dist/index.js"]
    }
  }
}

Claude Code：写入 ~/.claude/settings.json：

{
  "mcpServers": {
    "wps-office": {
      "command": "node",
      "args": ["/Users/你的用户名/项目路径/wps-skills/wps-office-mcp/dist/index.js"]
    }
  }
}

Step 3：安装 WPS 加载项（最关键！）

很多人卡在这一步。注意，这步需要人工点一下，因为需要修改 WPS 的本地配置。

macOS：bash scripts/auto-install-mac.sh
Windows：在 PowerShell 中执行 powershell scripts/install.ps1

⚠️ 重要提示：运行完脚本后，必须完全关闭 WPS（退出所有进程）再重启。重启后，你应该能在 WPS 顶部菜单栏看到类似“Claude助手”的选项卡。

Step 4：验证成功

在终端执行 node wps-office-mcp/dist/index.js，如果看到 "MCP Server started successfully"，恭喜你，配置已经跑通了！

深入底层：它到底是怎么工作的？

理解这个架构，能帮你更好地调教它。wps-skills 设计了一个非常优雅的三层结构：

Skills 层（大脑）：AI 读取 SKILL.md 文件，理解“什么时候用什么工具”。
MCP Server 层（神经）：提供 243 个具体的工具接口，如 write_cell、add_animation。
执行层（手脚）：
- macOS 通过 wpsClient 桥接。
- Windows 通过 PowerShell + COM 直接操控窗口。

关键认知：它不是去修改你硬盘里的 docx 文件（那本质是个压缩包，改多了容易崩）。它是“真的在驱动你打开的 WPS 窗口”——你眼睛看着文档修改，AI 在背后替你点鼠标、敲键盘。

编程调用：写一段代码让 AI 帮你做周报

配置好后，你可以直接用 Python 调用 MCP 服务。以下是一个极简示例，演示如何连接并让 AI 自动创建文档和写表格：

import asyncio
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async def create_report():
    # 1. 连接本地 MCP 服务
    server_params = StdioServerParameters(
        command="python",
        args=["-m", "wps_server"] 
    )

    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()

            # 2. 发出指令：创建 Word 文档
            await session.call_tool(
                "create_document",
                arguments={"filename": "Q3工作总结", "content": "核心数据上升 15%..."}
            )

            # 3. 发出指令：往 Excel 写入数据
            await session.call_tool(
                "write_cell",
                arguments={"file": "财务表.xlsx", "cell": "B2", "value": "1,024,000"}
            )

            print("✅ Agent 任务执行完毕，WPS 已自动更新！")

if __name__ == "__main__":
    asyncio.run(create_report())

这段代码只是冰山一角。利用 243 个工具，你甚至可以告诉 AI：“帮我写一份关于新能源的 PPT，10 页，蓝色科技风，并把第一页的标题改成‘未来已来’”——而这只需要一句自然语言。

进阶探索：不只 Word 和 Excel

WPS 笔记：WPS 笔记客户端本身可以作为 MCP 服务。这意味着 AI 可以把思考过程、会议纪要直接写进你的笔记库，实现“干活 + 存档”一体化。
企业级扩展：如果你有企业账号，WPS 365 开放平台支持接入私有知识库，你可以打造一个“只懂你们公司数据”的内部 AI 助理。

排错 TIPS

意外情况	大概率解决方案
WPS 没反应，说找不到文档	确保你想操作的文档已经在 WPS 中处于打开状态。
加载项显示不出来	重启 WPS 没用的话，试着以管理员/根权限执行安装脚本。
MCP Server 报错 `Cannot find module`	检查 `mcp.json` 里的路径是不是绝对路径，`~` 有时不生效。
Windows 下 COM 报错	检查 WPS 是否安装完整，必须开启 WPS 的 COM 自动化选项。

写在最后

以前，AI 办公受限于“读写权限”的鸿沟。MCP 协议彻底打破了这堵墙。

对于个人开发者而言，WPS + MCP 的组合意味着我们不需要再对着官方 API 文档苦等，借助开源社区的力量，几分钟就能让 Claude 真正“上手”干活。

AI 不缺聪明的大脑，缺的是能伸进办公软件的双手。而现在，这双手就摆在你的键盘上。

动手试试吧，让你的 WPS 长出 AI 的翅膀。

如果你在配置中踩了什么坑，或者成功跑通了什么有趣的应用，欢迎在评论区留言分享！ 🚀

DEV Community