Excel-MCP-服务器

Name: Excel-MCP-服务器
Author: negokaz

作者：negokaz604 星标更新：2025-07-19

安装使用来源：spider==github.com

项目介绍

Excel MCP Server

这是一个模型上下文协议（MCP）服务器，用于读取和写入MS Excel数据。

功能

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

🪟仅限Windows：

实时编辑
从工作表捕获屏幕图像

更多详情，请参阅工具部分。

要求

Node.js 20.x或更高版本

支持的文件格式

xlsx (Excel工作簿)
xlsm (启用宏的Excel工作簿)
xltx (Excel模板)
xltm (启用宏的Excel模板)

安装

通过NPM安装

excel-mcp-server会通过添加以下配置到MCP服务器配置中自动安装。

对于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自动安装Excel MCP Server给Claude Desktop：

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]

许可证

excel-mcp-server发布于MIT许可证下