Excel数据处理服务

Excel MCP服务器

读取和写入MS Excel数据的模型上下文协议（MCP）服务器。

特性

• 读取/写入文本值
• 读/写公式
• 创建新图纸

🪟仅限Windows：

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

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

需求

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

支持的文件格式

• xlsx（Excel书籍）
• xlsm（支持Excel宏的书籍）
• xltx（Excel模板）
• xltm（启用Excel宏的模板）

安装

通过NPM安装

通过将以下配置添加到mcp服务器配置中，可以自动安装excelmcp服务器。

对于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安装

通过以下方式自动安装Excel MCP Server for Claude Desktop 史密瑟里:

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

Tools

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：字体样式（粗体、斜体、下划线、大小、罢工、颜色、vertAlign）
    • fill：填充/背景样式（类型、图案、颜色、阴影）
    • numFmt：自定义数字格式字符串
    • decimalPlaces：小数位数（0-30）

Configuration

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

EXCEL_MCP_PAGING_CELLS_LIMIT

在单个分页操作中要读取的最大单元格数。
[默认值：4000]

许可证

版权所有（c）2025 Kazuki Negoro

excelmcp服务器在 MIT许可证