mcpField
E
excel-cli

excel-cli

github.com/sbroenne文档处理8341.0k 次安装今天更新
代码仓库

关于 excel-cli

excel-cli 是用于操作 Excel 工作簿的技能，指导 Agent 通过插件启动器发现并连接现有工作簿。它侧重保留未保存的编辑，并要求依据命令帮助和实际状态执行操作。

主要功能

  1. 01通过插件启动器运行 CLI
  2. 02发现并附加已打开的工作簿
  3. 03检查操作的部分结果与错误
  4. 04明确控制保存和关闭行为

适用场景

  1. 01检查现有工作簿并进行授权修改
  2. 02在 Excel 中保留未保存编辑
  3. 03排查失败或超时的工作簿操作

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/sbroenne/mcp-server-excel --skill excel-cli

安装后在 Claude Code 中输入/excel-cli确认已加载。

详细介绍

Excel CLI 发现

该插件不会将 excelcli 放到 PATH 中。其启动器会运行 npx -y @sbroenne/excelcli@latest；不要假设已安装独立可执行文件，也不要恢复已停用的 GitHub-release 下载器。

对于此技能的插件捆绑副本，相对于包含此 SKILL.md 的目录，..\..\bin\start-cli.ps1 可定位插件启动器。 将下方的 <plugin-root> 替换为该插件实际的安装目录： 请在 PowerShell 7.4 或更高版本（pwsh）中运行这些命令，而不是在 Windows PowerShell 5.1 中运行。

& "<plugin-root>\bin\start-cli.ps1" --help
& "<plugin-root>\bin\start-cli.ps1" session --help

后续命令都使用同一个完整启动器路径，尤其是带引号的 JSON 参数。通过原生命令 --help 查明准确的命令名称、标志、默认值以及保存／关闭行为；不要臆造语法。

检查与请求相关的现有工作簿状态。保留无关内容，只保存获准的结果。如果操作失败，请检查其报告的部分状态，不要假设已回滚或自动清理。 打开工作簿前，运行 session discover 查找已打开的工作簿。确认目标 workbookId，然后使用 session attach --workbook-id <ID>，以免重新打开工作簿。检查发现结果中的 complete 和 errors；扫描不完整时，不能据此断定工作簿不存在。Attach 会保留未保存的编辑，并在服务退出时让工作簿保持打开状态。其响应会报告当前的 AutoSave 设置；open 也会保留该设置。如果已启用，Excel 可能会自动保存编辑。服务正常关闭时，自有且未保存的工作簿会保持打开并可见，不会保存或丢弃；已完成的任务应显式保存并关闭。 如果等待超时，请检查 session list 中操作的开始时间、待处理工作以及最终结果；不要自动重试。活动请求数为零并不代表 Excel 已完成操作。完成后检查工作簿。 service status 和 service stop 会报告此前服务记录的 Excel 副本。停止已停止的服务会让这些副本保持打开状态，且不会妨碍启动新服务。service stop 始终会停止服务；如果工作簿正忙，或其状态无法确认，则会让该 Excel 副本保持原样，并在 shutdownWarning 中报告。使用发现和显式附加来检查这些副本；信息未知或不完整并不意味着可以结束 Excel。 对于 JSON 错误，将 errorMessage 视为唯一的错误文本字段；如果存在 errorCategory，请用它来指导恢复操作。 仅在用户要求呈现报告时加载 excel-cli-report-formatting；普通 Excel 读取或定向更新时不要加载。

评论

支持 Markdown