【开源项目简介】lc2panda / wps-skills

一、基础介绍

GitHub开源项目 lc2panda/wps-skills：https://github.com/lc2panda/wps-skills/tree/main，可通过 MCP协议让 AI Agent以自然语言操控 WPS Office 的文字、表格、演示三大组件。项目共注册 236 个 MCP 工具，其中工具层定义 224 个，MCP Server 内部注册 12 个。

表格工具（80 个）：覆盖数据读写（读取指定范围的二维数组、写入数据到指定区域）、公式计算（设置公式、根据自然语言描述生成公式、诊断错误公式、求值计算）、图表创建与更新、透视表创建与刷新、格式设置（字体、颜色、边框、数字格式、合并单元格、列宽行高）、条件格式、数据验证、数据清洗（去重、排序、查找替换、自动填充、文本分列、分类汇总、转置）、行列操作（插入、删除、隐藏、显示、分组）、工作表管理（创建、删除、重命名、复制、切换、移动、冻结窗格、命名范围）、工作簿管理（打开、新建、切换、关闭、获取信息）以及批注与保护（添加/删除批注、锁定单元格、保护工作表和工作簿）。

演示工具（111 个）：覆盖幻灯片管理（新增、删除、复制、移动、切换、设置版式与尺寸）、形状操作（添加、删除、设置位置、阴影、渐变、边框、透明度、对齐、分布、组合）、文本框管理、图片插入与删除、表格插入与样式设置、动画配置（添加、删除、排序、预设、强调动画）、幻灯片切换效果、背景设置（颜色、图片、渐变）、样式美化（自动美化、批量美化、配色方案、KPI 卡片、样式化表格、标题装饰、页码指示器）、图表与流程图（插入图表、设置数据与样式、创建流程图、组织架构图、时间轴）、数据可视化（进度条、仪表盘、迷你图表、环形图、网格布局、智能分布）、三维效果（旋转、深度、材质、三维文字）、母版管理、超链接、文本查找替换、幻灯片放映以及演示文稿级别的创建、打开、关闭与切换。

文字工具（24 个）：覆盖文本插入、查找替换、插入表格与图片、段落格式设置、字体样式与颜色设置、批注插入、文档管理（获取已打开文档列表、切换、打开、获取全文）、页眉页脚、目录生成、分页符与分节符插入、行间距设置、样式应用、书签插入以及页面布局设置。

上述工具覆盖了日常办公中常见的文档处理需求。例如，批量生成格式统一的报表时，可组合使用工作簿管理、数据写入、格式设置和图表创建工具；制作季度汇报演示时，可依次调用幻灯片创建、数据可视化图表、样式美化和动画配置工具。对于未被预定义工具覆盖的操作，wps_execute_method 提供了兜底机制，允许直接传入 WPS API 方法名和参数执行任意操作。

通用及内置工具（21 个）：包括文件保存与另存为、格式转换（PDF、doc、xlsx、ppt、rtf、csv、html 等）、连接状态检测、选区文本读取与替换、万能方法调用（直接执行任意 WPS API）、以及跨应用数据缓存（写入、读取、列出、清除），解决 macOS 端加载项无法直接跨应用操作的问题。

二、安装与使用

2.1 前提条件

• 已安装 WPS Office（Windows 或 macOS 版本）

• Node.js 版本不低于 18.0.0

• Git

2.2 安装步骤

向你的AI Agent发送以下指令;

2.3 使用方式

安装完成后，用户在 Claude Code 或 Cursor 中直接以自然语言下达指令即可操控 WPS Office。例如输入"读取当前表格 A1 到 D20 的数据"，AI 编程助手调用 wps_excel_read_range 工具完成操作；输入"创建一份包含 5 张幻灯片的季度汇报"，助手依次调用幻灯片创建、文本框插入、样式设置等工具；输入"将当前文档标题设为黑体二号加粗"，助手调用文字文档格式化工具。技能文件（SKILL.md）引导 AI 根据任务语义自动选择工具组合，用户无需记忆工具名称和参数。所有工具的输入输出均为结构化 JSON，AI 编程助手能够准确解析执行结果并据此做出后续决策。MCP 工具的每次调用都会返回操作是否成功的状态信息，AI 可根据返回结果判断是否需要重试或调整策略。