excel-webview2-mcp

Excel WebView2 MCP

为运行在 WebView2 中的 Microsoft Excel 加载项提供专业的 MCP 连接能力。

重要

从 v0.0.2 起，此服务可以为你启动 Excel 并旁加载加载项。使用前无需再启动开发服务器或连接调试器——excel_launch_addin 会启动本地开发服务器（如果已配置），并在启用 WebView2 远程调试的情况下启动 Excel，端口为 9222。 仍然支持手动预先启动：如果 Excel 加载项已在运行，且在 9222 端口启用了远程调试，服务会连接到该加载项。

v0.0.2 中的新功能

• 加载项生命周期管理——新增工具，可直接从 Claude Code 启动和停止 Excel 加载项：
  • excel_detect_addin — 为当前项目查找清单和开发服务器配置。
  • excel_launch_addin — 启动开发服务器（如有需要），并旁加载加载项启动 Excel，同时启用 CDP 端口 9222。
  • excel_stop_addin — 关闭已启动的 Excel 会话和开发服务器进程树。
• 只读 Excel 检查工具——提供丰富的只读操作，用于检查工作簿、工作表、区域、表格、数据透视表、图表等。这些操作都不会更改工作簿状态：
  • 上下文与结构：excel_context_info、excel_workbook_info、excel_list_worksheets、excel_worksheet_info、excel_active_range、excel_used_range。
  • 区域读取：excel_read_range、excel_range_properties、excel_range_formulas、excel_range_special_cells、excel_find_in_range。
  • 格式与验证：excel_list_conditional_formats、excel_list_data_validations。
  • 表格与名称：excel_list_tables、excel_table_info、excel_table_rows、excel_table_filters、excel_list_named_items。
  • 批注与形状：excel_list_comments、excel_list_shapes。
  • 计算与数据透视表：excel_calculation_state、excel_list_pivot_tables、excel_pivot_table_info、excel_pivot_table_values。
  • 图表：excel_list_charts、excel_chart_info、excel_chart_image。
  • 其他：excel_custom_xml_parts、excel_settings_get。
• 基于套接字的端口检测取代 HTTP 轮询，可在 Node 24 上更可靠地检查开发服务器和 CDP 是否就绪。
• 改进 Windows 上的清理机制——excel_stop_addin 现在会通过 taskkill 强制结束开发服务器进程树。

Fork 说明

此仓库是 Chrome DevTools MCP 仓库 ChromeDevTools/chrome-devtools-mcp 的一个 Fork。它保留了上游 DevTools 和 MCP 基础，同时针对托管在 WebView2 中的 Microsoft Excel 加载项调整了连接模型。

此项目的功能

• 通过 Chrome DevTools Protocol（CDP）将 Claude Code 连接到本地运行的 Excel 加载项。
• 提供 MCP 工具，用于检查、自动化、截屏、访问控制台、检查网络和分析性能。
• 面向 Excel 加载项使用的嵌入式 WebView2 运行时，而非独立的 Chrome 会话。

连接模型

Claude Code
    |
    v
excel-webview2-mcp
    |
    v
WebView2 remote debugging endpoint (localhost:9222)
    |
    v
Locally running Excel add-in

这一区别很重要：excel-webview2-mcp 是连接到现有调试会话的桥梁，而不是启动或托管加载项的组件。

前置条件

支持以下两种工作流：

自动启动（推荐，v0.0.2+）

1. Office 加载项项目（包含 manifest.xml 和开发服务器脚本）位于磁盘上。
2. Windows 上已安装 Excel 桌面版。
3. 已安装 Node.js，并且可以运行 npx @dsbissett/excel-webview2-mcp@latest。

先调用 excel_detect_addin，确认已发现该项目；然后调用 excel_launch_addin，启动开发服务器并将加载项旁加载到已启用 CDP 端口 9222 的 Excel 中。使用 excel_stop_addin 彻底停止所有相关进程。

手动 / 已预先连接

1. Excel 加载项已在本地 Excel 桌面客户端中加载并运行。
2. 已启用 WebView2 远程调试，并绑定到端口 9222（参见使用调试端口启动 Excel）。
3. 可通过 http://127.0.0.1:9222 访问调试端点。

使用以下命令验证：

curl http://127.0.0.1:9222/json

使用调试端口启动 Excel

本节适用于 Windows 上的 Excel 桌面版。根据 Microsoft 的 WebView2 和 Office 加载项文档，将 Chromium 标志传递给 WebView2 运行时的受支持方式是使用 WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS。WebView2 团队还记录了一种基于注册表的备用方案，可用于持久配置。

如果你使用的是 Mac 版 Excel，则此 MCP 服务不适用。Microsoft 记录的 Mac 版 Excel 调试方式是使用 Safari Web Inspector，而不是 WebView2 CDP 端口。

来源：

• WebView2 调试参数和注册表策略：https://learn.microsoft.com/en-us/microsoft-edge/webview2/how-to/debug-visual-studio-code
• 使用 Edge DevTools 调试 Office 加载项：https://learn.microsoft.com/en-us/office/dev/add-ins/testing/debug-add-ins-using-devtools-edge-chromium
• Office 加载项调试概述（包括 Mac）：https://learn.microsoft.com/en-us/office/dev/add-ins/testing/debug-add-ins-overview

Windows：推荐的本地开发设置

启动 Excel 前设置环境变量，以便 Excel 进程继承该变量：

$env:WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS="--remote-debugging-port=9222"

然后：

1. 从同一个 shell 启动 Excel，或者通过继承了该变量的父进程启动 Excel。
2. 在本地启动加载项。
3. 确认调试端点正常运行。

操作示例：

$env:WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS="--remote-debugging-port=9222"
start excel.exe

Office 加载项团队为使用 WebView2 托管的加载项通用地记录了这种环境变量机制，WebView2 团队则记录了 --remote-debugging-port=9222 是有效的浏览器参数。

Windows：持久化注册表备用方案

如果需要持久的本机设置，WebView2 团队记录了以下注册表策略路径：

HKEY_CURRENT_USER\Software\Policies\Microsoft\Edge\WebView2\AdditionalBrowserArguments

使用以下值：

• 值名称：EXCEL.EXE
• 值数据：--remote-debugging-port=9222

本地开发时请优先使用环境变量。它更容易启用和关闭，也能避免留下持久的全机设置。

验证端点

运行：

curl http://127.0.0.1:9222/json/version

正常响应为 JSON，并包含如下字段：

{
  "Browser": "...",
  "Protocol-Version": "...",
  "webSocketDebuggerUrl": "ws://127.0.0.1:9222/devtools/browser/..."
}

如果该 curl 命令失败，说明 Excel 尚未公开 WebView2 调试端口，excel-webview2-mcp 将无法连接。

安装

此服务以 npm 包 @dsbissett/excel-webview2-mcp 的形式发布，并通过 npx 调用。以下配置适用于所有宿主——只有配置文件的位置不同。

标准 MCP 条目：

{
  "mcpServers": {
    "excel-webview2": {
      "command": "npx",
      "args": ["@dsbissett/excel-webview2-mcp@latest"]
    }
  }
}

claude mcp add excel-webview2 -- npx @dsbissett/excel-webview2-mcp@latest

[mcp_servers.excel-webview2]
command = "npx"
args = ["@dsbissett/excel-webview2-mcp@latest"]

验证安装

添加服务后，请模型在 Office 加载项项目目录中调用 excel_detect_addin。如果成功响应，则说明 MCP 服务已正确连接；之后，excel_launch_addin 会负责启动 Excel。

默认情况下，服务会连接到本地 WebView2 调试端点 http://127.0.0.1:9222。

本地开发

npm install
npm run build
npm start

支持的 Node.js 版本为 ^20.19.0、^22.12.0 或 >=23。