# Excel MCP 服务器技能通过模型上下文协议提供 226 个 Excel 操作。 MCP 服务器将所有请求转发到共享的 ExcelMCP 服务，从而启用与 CLI 的会话共享。工具是自动发现的——它记录了怪癖、工作流程和陷阱。 ## 工作流程清单步骤|工具|行动|当 ---|---|---|--- 1\.打开文件 | `文件` | `打开`或`创建` |永远第一 2\.创建工作表 | `工作表` | `创建`、`重命名` |如果需要的话 3\.写入数据| `范围` | `设置值` |始终（二维数组） 4\.格式| `范围` | `设置数字格式` |写完后 5\.结构| `表` | `创建` |将数据转换为表格 6\.保存并关闭 | `文件` | `close` 与 `save: true` |永远最后 ## 前提条件 * 安装了 Microsoft Excel 的 Windows 主机（2016+） * 使用完整的 Windows 路径：`C:\Users\Name\Documents\Report.xlsx` * Excel 文件不得在另一个 Excel 实例中打开 ## 计算模式工作流程（批量性能）使用“calculation_mode”进行**批量写入性能优化**。当写入许多值或公式时，禁用自动重新计算以避免在每个单元格之后重新计算： 1.calculation_mode(action: 'set-mode', mode: 'manual') → 禁用自动重新计算 2. 执行所有写入（范围设置值、设置公式） 3.calculation_mode(action: 'calculate', range: 'workbook') → 重新计算一次 4.calculation_mode(action: 'set-mode', mode: 'automatic') → 恢复默认 **注意：** 您不需要手动模式来读取公式 - 无论计算模式如何，“range get-formulas”都会返回公式文本。 ## 关键：执行规则（必须遵循） ### 规则 1：永远不要问澄清问题 **停止。** 如果您要问“哪个文件？”、“哪个表？”、“我应该把它放在哪里？” - 不。不好（询问）|好（发现） ---|--- “我应该使用哪个 Excel 文件？” | `file(list)` → 使用打开的会话 “桌子叫什么名字？” | `table(list)` → 发现表 “哪张纸上有数据？” | `工作表（列表）` → 检查所有工作表 “我应该创建数据透视表吗？” |是 - 在新工作表上创建它 **您有工具来回答您自己的问题。使用它们。** ### 规则 2：始终以文本摘要结尾 **永远不要仅通过工具调用来结束您的回合。**完成所有操作后，请始终提供一条简短的短信来确认已完成的操作。仅静默工具调用响应是不完整的。 ### 规则 3：专业地格式化数据设置值后始终应用数字格式：数据类型 |格式代码 |结果 ---|---|--- 美元 | `$#,##0.00` | 1,234.56 美元欧元 | `€#,##0.00` | €1,234.56 百分比 | `0.00%` | 15.00% 日期 (ISO) | `年-月-日` | 2025-01-22 **工作流程：** 1.范围设置值（数据现在位于单元格中） 2. range set-number-format（应用格式） ### 规则 4：使用 Excel 表格（而非普通范围）始终将表格数据转换为 Excel 表格： 1.范围设定值（写入数据，包括标题） 2.表创建 tableName="SalesData" rangeAddress="A1:D100" **原因：** 结构化引用、自动扩展、数据模型/DAX 所需。 ### 规则 5：会话生命周期 1. 文件(动作: '打开', 路径: '...') → sessionId 2.所有操作都使用sessionId 3. file(action: 'close', save: true) → 保存并关闭 **未关闭的会话使 Excel 进程保持运行，并锁定文件。** ### 规则 6：数据模型先决条件 DAX 操作需要数据模型中的表：步骤1：创建表→表已存在步骤 2：表（操作：'添加到数据模型'）→ 数据模型中的表第 3 步：datamodel(action: 'create-measure') → 现在可以了 ### 规则 7：Power Query 开发生命周期 **最佳实践：测试优先的工作流程** 1. powerquery(action: 'evaluate', mCode: '...') → 不持久化测试 2. powerquery(action: 'create', ...) → 存储经过验证的查询 3. powerquery(action: 'refresh', ...) → 加载数据 **为什么先评估：** * 在创建永久查询之前捕获语法错误和丢失的源 * 比创建/更新时的 COM 异常更好的错误消息 * 查看实际数据预览（列+示例行） * 无需清理 - 就像 M 代码的 REPL * 仅跳过简单的文字表 **常见错误：** 创建/更新而不评估 → 损坏的查询会污染工作簿 ### 规则 8：有针对性的更新而不是删除重建 * **首选** ：在特定范围内设置值（例如，第 5 行的“A5:C5”） * **避免**：删除并重新创建整个结构 **为什么：** 保留格式、公式和引用。 ### 规则 9：遵循建议的下一步操作错误响应包括可操作的提示： { “成功”：假， "errorMessage": "在数据模型中找不到表'销售'", “suggestedNextActions”：[“表（操作：'添加到数据模型'，表名称：'销售'）”] } ### 规则 10：使用计算模式提高批量写入性能当写入许多值/公式（10 个以上单元格）时，请使用“calculation_mode”以避免每次写入后重新计算： 1.calculation_mode(action: 'set-mode', mode: 'manual') → 禁用自动重新计算 2. 执行数据写入（范围设定值、设定公式） 3.calculation_mode(action: 'calculate', range: 'workbook') → 结束时重新计算一次 4.calculation_mode(action: 'set-mode', mode: 'automatic') → 恢复默认 **不需要时：** 阅读公式、进行少量编辑（1-10 个单元格）或需要立即计算结果时。 ## 工具选择快速参考任务|工具|关键行动 ---|---|--- 创建/打开/保存工作簿 | `文件` |打开、创建、关闭写入/读取单元格数据 | `范围` |设置值、获取值设置单元格格式 | `范围` |设置数字格式从数据创建表 | `表` |创造将表添加到 Power Pivot | `表` |添加到数据模型创建 DAX 公式 | `数据模型` |创建测量创建数据透视表 | `可旋转的` |创建，从数据模型创建用切片机过滤| `切片机` |设置切片器选择创建图表 | `图表` |从范围创建控制计算模式 | `计算模式` |获取模式、设置模式、计算目视验证 | `屏幕截图` |捕获、捕获表 ## 参考文档请参阅“references/”以获取详细指导： * [核心执行规则和LLM指南]() * [要避免的常见错误]() * [数据模型约束和模式]() * [图表和格式]() * [条件格式化操作]() * [仪表板和报告最佳实践]() * [数据模型/DAX 详细信息]() * [数据模型分析的DMV查询参考]() * [Power Query M 代码语法参考]() * [数据透视表操作]() * [Power Query 详细信息]() * [范围运算和数字格式]() * [屏幕截图和视觉验证]() * [切片器操作]() * [表操作]() * [工作表操作]()

Excel MCP

包含技能