Excel MCP 服务器

一个读取和写入 Microsoft Excel 数据的模型上下文协议 (MCP) 服务器。

功能

• 读取/写入文本值
• 读取/写入公式
• 创建新工作表

仅限 Windows：

• 实时编辑
• 捕获工作表的屏幕截图

更多详细信息，请参阅 工具 部分。

要求

• Node.js 20.x 或更高版本

支持的文件格式

• xlsx（Excel 工作簿）
• xlsm（启用宏的 Excel 工作簿）
• xltx（Excel 模板）
• xltm（启用宏的 Excel 模板）

安装

通过 NPM 安装

将以下配置添加到 MCP 服务器配置中，即可自动安装 excel-mcp-server。

对于 Windows：

{
    "mcpServers": {
        "excel": {
            "command": "cmd",
            "args": ["/c", "npx", "--yes", "@negokaz/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
            }
        }
    }
}

对于其他平台：

{
    "mcpServers": {
        "excel": {
            "command": "npx",
            "args": ["--yes", "@negokaz/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
            }
        }
    }
}

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Excel MCP 服务器：

npx -y @smithery/cli install @negokaz/excel-mcp-server --client claude

工具

excel_describe_sheets

列出指定 Excel 文件的所有工作表信息。

参数：

• fileAbsolutePath
  • Excel 文件的绝对路径

excel_read_sheet

分页读取 Excel 工作表中的值。

参数：

• fileAbsolutePath
  • Excel 文件的绝对路径
• sheetName
  • Excel 文件中的工作表名称
• range
  • 要读取的单元格范围（例如：“A1:C10”）。[默认：第一个分页范围]
• showFormula
  • 是否显示公式而不是值 [默认：false]
• showStyle
  • 是否显示单元格的样式信息 [默认：false]

excel_screen_capture

仅限 Windows 对 Excel 工作表进行分页截图。

参数：

• fileAbsolutePath
  • Excel 文件的绝对路径
• sheetName
  • Excel 文件中的工作表名称
• range
  • 要读取的单元格范围（例如：“A1:C10”）。[默认：第一个分页范围]

excel_write_to_sheet

向 Excel 工作表写入值。

参数：

• fileAbsolutePath
  • Excel 文件的绝对路径
• sheetName
  • Excel 文件中的工作表名称
• newSheet
  • 如果为 true，则创建新工作表；否则写入现有工作表
• range
  • 要读取的单元格范围（例如：“A1:C10”）。
• values
  • 要写入 Excel 工作表的值。如果值是公式，应以“=”开头。

excel_create_table

在 Excel 工作表中创建表格。

参数：

• fileAbsolutePath
  • Excel 文件的绝对路径
• sheetName
  • 创建表格的工作表名称
• range
  • 用作表格的范围（例如：“A1:C10”）
• tableName
  • 要创建的表格名称。

excel_copy_sheet

将现有工作表复制到新工作表。

参数：

• fileAbsolutePath
  • Excel 文件的绝对路径
• srcSheetName
  • Excel 文件中的源工作表名称
• dstSheetName
  • 要复制到的目标工作表名称。

excel_format_range

使用样式信息格式化 Excel 工作表中的单元格。

参数：

• fileAbsolutePath
  • Excel 文件的绝对路径
• sheetName
  • Excel 文件中的工作表名称
• range
  • Excel 工作表中的单元格范围（例如：“A1:C3”）
• styles
  • 每个单元格的样式对象二维数组。如果单元格不改变样式，则使用 null。数组的项目数必须与范围大小一致。
  • 样式对象属性：
    • border：边框样式数组（类型、颜色、样式）
    • font：字体样式（粗体、斜体、下划线、大小、删除线、颜色、垂直对齐）
    • fill：填充/背景样式（类型、图案、颜色、阴影）
    • numFmt：自定义数字格式字符串
    • decimalPlaces：小数位数（0–30）

配置

可以通过以下环境变量更改 MCP 服务器的行为：

EXCEL_MCP_PAGING_CELLS_LIMIT

单次分页操作中最多可读取的单元格数量。
[默认：4000]

许可证

版权所有 © 2025 Kazuki Negoro

excel-mcp-server 根据 MIT 许可证 发布。

Excel MCP Server 快速上手指南

Excel MCP Server 是一个基于模型上下文协议（MCP）的服务端工具，允许 AI 助手直接读取、写入和操作 Microsoft Excel 文件。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：
  • 通用功能：Windows, macOS, Linux
  • 实时编辑与截图功能：仅限 Windows 系统（需安装 Microsoft Excel）
• 运行时依赖：Node.js 20.x 或更高版本
• 支持的文件格式：.xlsx, .xlsm, .xltx, .xltm

提示：国内用户若遇到 npm 下载缓慢，可临时配置淘宝镜像源： npm config set registry https://registry.npmmirror.com

安装步骤

Excel MCP Server 通常通过配置 MCP 客户端（如 Claude Desktop）自动安装。请选择适合您系统的配置方式。

方式一：手动配置 MCP 服务器

将以下 JSON 配置添加到您的 MCP 配置文件（通常是 claude_desktop_config.json 或类似文件）的 mcpServers 字段中。

Windows 系统配置：

{
    "mcpServers": {
        "excel": {
            "command": "cmd",
            "args": ["/c", "npx", "--yes", "@negokaz/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
            }
        }
    }
}

macOS / Linux 系统配置：

{
    "mcpServers": {
        "excel": {
            "command": "npx",
            "args": ["--yes", "@negokaz/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
            }
        }
    }
}

方式二：使用 Smithery 一键安装（推荐）

如果您使用 Smithery 管理工具，可以通过以下命令自动为 Claude Desktop 安装：

npx -y @smithery/cli install @negokaz/excel-mcp-server --client claude

基本使用

安装并重启 MCP 客户端后，您可以直接在对话中指示 AI 操作 Excel 文件。以下是几个典型的使用场景：

1. 查看工作表信息

让 AI 列出指定 Excel 文件中所有工作表的名称和信息。

指令示例：“请列出 C:\Data\report.xlsx 文件中包含的所有工作表。” (底层调用工具：excel_describe_sheets)

2. 读取数据

读取特定工作表中的数据，支持指定范围和分页。

指令示例：“读取 data.xlsx 中 'Sheet1' 的 A1 到 C10 单元格的内容。” (底层调用工具：excel_read_sheet)

3. 写入数据或公式

向现有工作表或新工作表写入文本值或公式。

指令示例：“在 budget.xlsx 的 'Summary' 表中，将 B2 单元格设置为公式 =SUM(A1:A10)。” (底层调用工具：excel_write_to_sheet，公式需以 = 开头)

4. 高级功能 (Windows 专属)

• 屏幕截图：截取指定区域的工作表图像。

  “截取 project.xlsx 中 'Gantt' 表 A1:F20 区域的截图。”

• 格式化单元格：修改字体、边框、背景色等样式。

  “将 report.xlsx 中第一行的字体加粗并添加底边框。”

配置说明

您可以通过环境变量 EXCEL_MCP_PAGING_CELLS_LIMIT 调整单次读取的最大单元格数量（默认为 4000），以处理大型数据集。