Excel MCP Server

Excel MCP 服务

一个用于读取和写入 MS Excel 数据的 Model Context Protocol（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 Server：

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
  • 要读取的 Excel 工作表单元格范围（例如："A1:C10"）。[默认：第一个分页范围]
• showFormula
  • 显示公式而非值 [默认：false]
• showStyle
  • 显示单元格的样式信息 [默认：false]

excel_screen_capture

[仅限 Windows] 分页截取 Excel 工作表的屏幕截图。

参数：

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

excel_write_to_sheet

向 Excel 工作表写入值。

参数：

• fileAbsolutePath
  • Excel 文件的绝对路径
• sheetName
  • Excel 文件中的工作表名称
• newSheet
  • 如果为 true，则创建新工作表；否则写入现有工作表
• range
  • 要读取的 Excel 工作表单元格范围（例如："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]

许可证

版权所有 (c) 2025 Kazuki Negoro

excel-mcp-server 基于 MIT License 发布