Excel MCP Server

Excel MCP Server

site icon
2025.04.04 0
GoExcel处理数据读写办公自动化开发效率
Excel MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,专门用于读取和写入 Microsoft Excel 文件的数据。它支持多种 Excel 文件格式,包括 xlsx、xlsm、xltx 和 xltm。该服务提供了丰富的功能,如读取和写入文本值、公式,以及在 Windows 平台上捕获 Excel 文件的屏幕图像。
View on GitHub

Overview

基本能力

产品定位

Excel MCP Server 是一个专门用于处理 Microsoft Excel 文件数据的服务,旨在通过 MCP 协议提供高效的数据读写能力。

核心功能

  • 从 Excel 文件读取文本值
  • 向 Excel 文件写入文本值
  • 从 Excel 文件读取公式
  • 向 Excel 文件写入公式
  • 在 Windows 平台上捕获 Excel 文件的屏幕图像

适用场景

  • 自动化 Excel 数据处理
  • 批量修改 Excel 文件内容
  • 提取 Excel 文件中的公式和数据
  • 在 Windows 环境下生成 Excel 文件的屏幕截图

工具列表

  • read_sheet_names: 列出 Excel 文件中的所有工作表名称
  • read_sheet_data: 从 Excel 工作表中读取数据(支持分页)
  • read_sheet_formula: 从 Excel 工作表中读取公式(支持分页)
  • read_sheet_image: [仅限 Windows] 从 Excel 工作表中读取数据作为图像(支持分页)
  • write_sheet_data: 向 Excel 工作表写入数据
  • write_sheet_formula: 向 Excel 工作表写入公式

常见问题解答

  • 支持的文件格式:xlsx、xlsm、xltx、xltm
  • Windows 平台特有功能:捕获屏幕图像
  • 环境变量配置:可通过 EXCEL_MCP_PAGING_CELLS_LIMIT 设置单次分页操作读取的最大单元格数(默认4000)

使用教程

使用依赖

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

安装教程

通过 NPM 安装

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

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

调试方式

安装完成后,可以通过调用提供的工具函数进行调试,例如: - 列出工作表名称:read_sheet_names - 读取工作表数据:read_sheet_data - 写入数据:write_sheet_data

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。