当需要通过 WPS 表格 MCP 用自然语言完成…

适用于已接入 WPS Excel MCP 工具、希望用自然语言操控 WPS 表格解决公式、清洗、分析和图表问题的场景。

适用场景

解决思路

1. 分析用户想要完成什么任务，识别关键词：「查价格」「匹配」「对应」对应查找函数；「如果...就...」「判断」对应条件函数；「统计」「汇总」「求和」对应聚合函数；「去重」「清理」「整理」对应数据清洗。
2. 必须先调用 `wps_excel_generate_formula` 或 `wps_excel_read_range` 了解当前工作表结构：工作簿名称和所有工作表、当前选中的单元格、表头信息（列名与列号对应关系）、使用区域范围。
3. 根据需求和上下文生成解决方案：确定使用哪个函数或功能；构造正确的公式或参数；考虑边界情况和错误处理。
4. 直接调用对应的 MCP 工具完成操作：用 `wps_excel_set_formula` 设置公式；用 `wps_excel_clean_data` 数据清洗；用 `wps_excel_create_chart` 创建图表；用 `wps_excel_create_pivot_table` 创建透视表。
5. 向用户说明完成情况：执行了什么操作；公式的含义解释；如何验证结果；可能的后续操作建议。
6. 公式生成场景：调用 `wps_excel_generate_formula` 获取工作簿上下文（自动返回表头等信息）。
7. 公式生成场景：必要时调用 `wps_excel_read_range` 获取更多数据，例如发现 A列是产品名称，B列是价格。
8. 公式生成场景：分析应该使用 VLOOKUP 或 XLOOKUP。
9. 公式生成场景：生成公式 `=VLOOKUP(D2,$A$2:$B$100,2,FALSE)`。
10. 公式生成场景：解释公式：D2 是要查找的产品名称；$A$2:$B$100 是查找范围（绝对引用避免拖拽时范围变化）；2 表示返回第2列的值（价格）；FALSE 表示精确匹配。
11. 公式生成场景：调用 `wps_excel_set_formula` 写入公式。
12. 公式生成场景：告知用户可以向下拖拽填充。
13. 条件判断场景：获取上下文，确定销售额所在列；生成公式 `=IF(B2>10000,"达标","未达标")`；解释公式逻辑；写入并验证。
14. 多条件统计场景：获取上下文，确定地区列和销售额列；生成公式 `=COUNTIFS(A:A,"北京",B:B,">5000")`；解释多条件计数的逻辑；写入公式。
15. 公式报错场景：调用 `wps_excel_diagnose_formula` (参数: {cell: "出错单元格"}) 获取诊断信息；分析错误原因（可能删除了被引用的行/列）；提供修复建议：检查引用范围，更新公式。
16. 数据清洗场景：确认要清洗的范围；调用 `wps_excel_clean_data` 执行 `trim` 去除空格、`remove_empty_rows` 删除空行、`remove_duplicates` 删除重复行；报告清洗结果（处理了多少条数据）。
17. 公式诊断错误码：`#REF!` 引用了不存在的单元格或区域；`#N/A` 查找函数未找到匹配值；`#VALUE!` 参数类型错误；`#NAME?` 函数名称错误或引用了未定义的名称；`#DIV/0!` 除数为零。
18. 公式生成能力：查找匹配类用 VLOOKUP、XLOOKUP、INDEX+MATCH、LOOKUP；条件判断类用 IF、IFS、SWITCH、IFERROR；统计汇总类用 SUMIF、COUNTIF、AVERAGEIF、SUMIFS、COUNTIFS；日期时间类用 DATE、DATEDIF、WORKDAY、EOMONTH；文本处理类用 LEFT、RIGHT、MID、CONCATENATE、TEXT。
19. 数据清洗能力：去除前后空格（trim）；删除重复行（remove_duplicates）；删除空行（remove_empty_rows）；统一日期格式（unify_date）。
20. 数据分析能力：创建各类图表（柱状图、折线图、饼图等）；创建数据透视表；数据排序与筛选；条件格式设置。
21. 引用规范：相对引用 `A1` 拖拽时会自动变化；绝对引用 `$A$1` 拖拽时保持不变；混合引用 `$A1` 或 `A$1` 固定列或固定行；查找范围通常使用绝对引用，避免拖拽时出错。
22. 常用公式模板：精确查找 `=VLOOKUP(查找值, 查找范围, 返回列号, FALSE)`、`=XLOOKUP(查找值, 查找列, 返回列, "未找到")`；条件判断 `=IF(条件, 真值, 假值)`、`=IFS(条件1, 值1, 条件2, 值2, TRUE, 默认值)`、`=IFERROR(公式, 错误时返回值)`；条件统计 `=SUMIF(条件范围, 条件, 求和范围)`、`=COUNTIF(范围, 条件)`、`=SUMIFS(求和范围, 条件范围1, 条件1, 条件范围2, 条件2)`；日期处理 `=DATEDIF(开始日期, 结束日期, "Y")` 计算年数、`=WORKDAY(开始日期, 工作日数)` 计算工作日、`=EOMONTH(日期, 0)` 获取月末日期。
23. 安全原则：操作前确认数据范围，避免误操作重要数据；大规模操作前建议用户备份；操作后验证结果是否符合预期。
24. 沟通原则：不确定需求时先询问；公式要附带解释，让用户理解原理；多种方案时让用户选择；出错时提供详细分析和修复建议。
25. 性能考虑：避免全列引用，`A:A` 可能导致性能问题，尽量用具体范围；简化公式，能用简单公式解决的不用复杂公式；需要处理大量数据时分批进行。
26. 调用示例：`wps_excel_create_chart({ data_range: "A1:B10", chart_type: "line", title: "销售趋势" })`。
27. 调用示例：`wps_excel_clean_data({ range: "A1:D100", operations: ["trim", "remove_duplicates", "remove_empty_rows"] })`。
28. 调用示例：`wps_excel_create_pivot_table({ sourceRange: "A1:E100", destinationCell: "G1", rowFields: ["部门"], valueFields: [{ field: "销售额", aggregation: "SUM" }] })`。
29. 调用示例：`wps_excel_set_cell_format({ range: "A1:D1", format: { bold: true, fontSize: 14, bgColor: "#4472C4", fontColor: "#FFFFFF" } })`。
30. 调用示例：`wps_excel_get_sheet_list()`。
31. 工作簿管理工具：`wps_excel_open_workbook` 打开指定路径的 Excel 工作簿文件。
32. 工作簿管理工具：`wps_excel_get_open_workbooks` 获取当前所有已打开的 Excel 工作簿列表。
33. 工作簿管理工具：`wps_excel_switch_workbook` 切换到指定名称的 Excel 工作簿。
34. 工作簿管理工具：`wps_excel_close_workbook` 关闭指定的 Excel 工作簿，可选是否保存。
35. 工作簿管理工具：`wps_excel_create_workbook` 新建一个空白 Excel 工作簿。
36. 工作簿管理工具：`wps_excel_get_cell_value` 获取 Excel 指定单元格的值。
37. 工作簿管理工具：`wps_excel_set_cell_value` 设置 Excel 指定单元格的值。
38. 工作簿管理工具：`wps_excel_get_formula` 获取 Excel 指定单元格的公式。
39. 工作簿管理工具：`wps_excel_get_cell_info` 获取单元格的详细信息（值、公式、格式等）。
40. 工作簿管理工具：`wps_excel_clear_range` 清除指定范围的内容、格式或全部。
41. 公式工具：`wps_excel_set_formula` 在指定单元格设置 Excel 公式（必须以 = 开头）。
42. 公式工具：`wps_excel_generate_formula` 根据自然语言描述生成 Excel 公式。
43. 公式工具：`wps_excel_diagnose_formula` 诊断公式错误，分析原因并提供修复建议。
44. 公式工具：`wps_excel_evaluate_formula` 计算并返回公式结果。
45. 公式工具：`wps_excel_set_print_area` 设置打印区域。
46. 公式工具：`wps_excel_zoom` 设置工作表缩放比例。
47. 数据处理工具：`wps_excel_read_range` 读取 Excel 指定范围的单元格数据。
48. 数据处理工具：`wps_excel_write_range` 向 Excel 指定范围写入二维数组数据。
49. 数据处理工具：`wps_excel_clean_data` 数据清洗工具，支持多种清洗操作的组合。
50. 数据处理工具：`wps_excel_remove_duplicates` 删除指定范围内的重复行。
51. 数据处理工具：`wps_excel_sort_range` 对 Excel 选定区域按指定列排序。
52. 数据处理工具：`wps_excel_find_replace` 在 Excel 中查找并替换内容。
53. 数据处理工具：`wps_excel_insert_row` 在 Excel 中插入行。
54. 数据处理工具：`wps_excel_add_comment` 给单元格添加批注。
55. 数据处理工具：`wps_excel_protect_sheet` 保护或取消保护工作表。
56. 数据处理工具：`wps_excel_set_conditional_format` 设置条件格式。
57. 数据处理工具：`wps_excel_protect_workbook` 保护或取消保护工作簿，防止结构被修改。
58. 数据处理工具：`wps_excel_set_zoom` 设置当前工作表的缩放比例（10-400%）。
59. 高级数据工具：`wps_excel_auto_filter` 对 Excel 指定范围应用自动筛选。
60. 高级数据工具：`wps_excel_copy_range` 复制 Excel 指定范围到目标位置。
61. 高级数据工具：`wps_excel_paste_range` 粘贴已复制的内容到指定位置。
62. 高级数据工具：`wps_excel_fill_series` 自动填充序列数据。
63. 高级数据工具：`wps_excel_transpose` 转置数据（行列互换）。
64. 高级数据工具：`wps_excel_text_to_columns` 将文本按分隔符拆分到多列。
65. 高级数据工具：`wps_excel_subtotal` 创建分类汇总。
66. 图表工具：`wps_excel_create_chart` 在 Excel 中创建图表（柱状图/折线图/饼图/散点图等）。
67. 图表工具：`wps_excel_update_chart` 更新 Excel 图表的属性（标题/颜色/图例/数据标签等）。
68. 图表工具：`wps_excel_export_chart_as_image` 将工作表中的图表导出为 PNG/JPG/GIF/BMP 位图（Chart.Export 原生 API，1:1 像素级还原，替代 pdf2image 中转）。
69. 图表工具：`wps_excel_export_range_as_image` 将指定区域（如 A1:F20）导出为 PNG/JPG/GIF/BMP 位图（CopyPicture + 临时图表经典做法，1:1 还原表格视觉）。
70. 图表工具：支持的图表类型有 column_clustered, column_stacked, bar_clustered, line, line_markers, pie, doughnut, scatter, area, radar。
71. 图表导出示例：`wps_excel_export_chart_as_image({ chartName: "Chart 1", outputPath: "/Users/me/Downloads/chart1.png", format: "PNG" })`，适用于把销售柱状图导成 PNG、把图表保存成高清图片用于报告等场景。
72. 区域导出示例：`wps_excel_export_range_as_image({ range: "A1:F20", outputPath: "/Users/me/Downloads/table.png", format: "PNG" })`，适用于把表格区域保存为图片、导出数据区贴到 PPT 等场景；注意此方法依赖剪贴板，headless 模式下可能失败。
73. 透视表工具：`wps_excel_create_pivot_table` 创建 Excel 透视表，用于数据汇总和分析。
74. 透视表工具：`wps_excel_update_pivot_table` 更新已有透视表的配置（添加/移除字段、修改聚合方式等）。
75. 工作表管理工具：`wps_excel_create_sheet` 在当前工作簿中创建新的工作表。
76. 工作表管理工具：`wps_excel_delete_sheet` 删除当前工作簿中的指定工作表（不可撤销）。
77. 工作表管理工具：`wps_excel_rename_sheet` 重命名当前工作簿中的指定工作表。
78. 工作表管理工具：`wps_excel_copy_sheet` 复制当前工作簿中的指定工作表。
79. 工作表管理工具：`wps_excel_get_sheet_list` 获取当前工作簿的所有工作表列表。
80. 工作表管理工具：`wps_excel_switch_sheet` 切换到指定的工作表。
81. 工作表管理工具：`wps_excel_move_sheet` 移动指定工作表到新的位置。
82. 工作表管理工具：`wps_excel_get_selection` 获取当前 Excel 中选中区域的信息。
83. 工作表管理工具：`wps_excel_delete_row` 删除指定行（可指定起始行号和删除行数）。
84. 工作表管理工具：`wps_excel_insert_column` 在指定位置插入列（可指定起始列号和插入列数）。
85. 工作表管理工具：`wps_excel_delete_column` 删除指定列（可指定起始列号和删除列数）。
86. 工作表管理工具：`wps_excel_freeze_panes` 冻结/取消冻结窗格。
87. 工作表管理工具：`wps_excel_auto_fill` 自动填充单元格区域（根据源区域数据模式自动填充）。
88. 工作表管理工具：`wps_excel_set_named_range` 设置命名范围（为指定单元格区域创建或更新命名范围）。
89. 工作表管理工具：`wps_excel_hide_column` 隐藏或显示指定列。
90. 工作表管理工具：`wps_excel_auto_sum` 对指定范围的列或行自动求和。
91. 格式化工具：`wps_excel_set_cell_format` 设置 Excel 单元格格式（字体/颜色/背景色/粗体/斜体/字号等）。
92. 格式化工具：`wps_excel_set_cell_style` 应用预定义样式到 Excel 单元格（标题/强调/输入/输出等）。
93. 格式化工具：`wps_excel_set_border` 设置 Excel 单元格边框样式（支持不同粗细、位置和颜色）。
94. 格式化工具：`wps_excel_set_number_format` 设置 Excel 单元格的数字格式。
95. 格式化工具：`wps_excel_merge_cells` 合并 Excel 指定范围的单元格。
96. 格式化工具：`wps_excel_unmerge_cells` 拆分 Excel 中已合并的单元格。
97. 格式化工具：`wps_excel_set_column_width` 设置 Excel 指定列的列宽（支持单列或连续多列）。
98. 格式化工具：`wps_excel_set_row_height` 设置 Excel 指定行的行高。
99. 格式化工具：`wps_excel_hide_row` 隐藏或显示 Excel 指定行（可一次操作连续多行）。
100. 格式化工具：`wps_excel_set_data_validation` 设置 Excel 单元格的数据验证规则（下拉列表/数值范围/日期范围等）。
101. 行列工具：`wps_excel_insert_rows` 在 Excel 中指定位置插入一行或多行。
102. 行列工具：`wps_excel_insert_columns` 在 Excel 中指定位置插入一列或多列。
103. 行列工具：`wps_excel_delete_rows` 删除 Excel 中指定位置的一行或多行。
104. 行列工具：`wps_excel_delete_columns` 删除 Excel 中指定位置的一列或多列。
105. 行列工具：`wps_excel_hide_rows` 隐藏 Excel 中指定范围的行。
106. 行列工具：`wps_excel_show_rows` 显示 Excel 中已隐藏的行。
107. 行列工具：`wps_excel_show_columns` 显示 Excel 中已隐藏的列。
108. 行列工具：`wps_excel_group_rows` 对 Excel 中指定范围的行进行分组（便于折叠/展开管理）。
109. 批注保护工具：`wps_excel_delete_cell_comment` 删除 Excel 单元格上的批注。
110. 批注保护工具：`wps_excel_get_cell_comments` 获取 Excel 指定范围内的所有批注。
111. 批注保护工具：`wps_excel_unprotect_sheet` 取消保护当前工作表。
112. 批注保护工具：`wps_excel_lock_cells` 锁定或解锁 Excel 指定范围的单元格（需配合工作表保护使用）。
113. 批注保护工具：`wps_excel_set_array_formula` 为 Excel 指定范围设置数组公式（CSE 数组公式）。
114. 批注保护工具：`wps_excel_insert_excel_image` 在 Excel 中插入图片到指定位置。
115. 批注保护工具：`wps_excel_set_hyperlink` 为 Excel 单元格设置超链接。

适用边界 · 注意事项

• 没有安装 WPS Office 或未注册对应 WPS Excel MCP 工具时不可用。
• 需要操作 Microsoft Excel 原生对象模型、Google Sheets 或其他表格软件时不一定适用。
• `wps_excel_export_range_as_image` 依赖剪贴板，headless 模式下可能失败。