Excel MCP 服务器

<img src="docs/img/icon-800.png" width="128">

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

功能特性

• 从 MS Excel 文件读取文本值
• 将文本值写入 MS Excel 文件
• 从 MS Excel 文件读取公式
• 将公式写入 MS Excel 文件
• 从 MS Excel 文件捕获屏幕图像（仅限 Windows）

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

要求

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

支持的文件格式

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

安装

通过 NPM 安装

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

使用 stdio 传输（默认）

对于 Windows：

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

对于其他平台：

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

使用 SSE 传输

对于 Windows：

{
    "mcpServers": {
        "excel": {
            "command": "cmd",
            "args": ["/c", "npx", "--yes", "@fbeawels/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000",
                "EXCEL_MCP_TRANSPORT": "sse",
                "EXCEL_MCP_HOST": "0.0.0.0",
                "EXCEL_MCP_PORT": "8000"
            }
        }
    }
}

对于其他平台：

{
    "mcpServers": {
        "excel": {
            "command": "npx",
            "args": ["--yes", "@fbeawels/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000",
                "EXCEL_MCP_TRANSPORT": "sse",
                "EXCEL_MCP_HOST": "0.0.0.0",
                "EXCEL_MCP_PORT": "8000"
            }
        }
    }
}

当使用 SSE 传输时，服务器将启动一个 HTTP 服务器，包含以下端点：

• /sse - 用于接收来自服务器的事件的 SSE 端点
• /command - 用于向服务器发送命令的 POST 端点
• /status - 用于检查服务器状态的 GET 端点

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Excel MCP Server：

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

<h2 id="tools">工具</h2>

read_sheet_names

列出 Excel 文件中的所有工作表名称。

参数：

• fileAbsolutePath
  • Excel 文件的绝对路径

read_sheet_data

从 Excel 工作表中读取数据，支持分页。

参数：

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

read_sheet_formula

从 Excel 工作表中读取公式，支持分页。

参数：

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

read_sheet_image

[仅限 Windows] 将数据作为图像从 Excel 工作表中读取，支持分页。

参数：

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

write_sheet_data

将数据写入 Excel 工作表。

参数：

• fileAbsolutePath
  • Excel 文件的绝对路径
• sheetName
  • Excel 文件中的工作表名称
• range
  • 要在 Excel 工作表中读取的单元格范围（例如，“A1:C10”）。
• data
  • 要写入 Excel 工作表的数据

write_sheet_formula

将公式写入 Excel 工作表。

参数：

• fileAbsolutePath
  • Excel 文件的绝对路径
• sheetName
  • Excel 文件中的工作表名称
• range
  • 要在 Excel 工作表中读取的单元格范围（例如，“A1:C10”）。
• formulas
  • 要写入 Excel 工作表的公式（例如，“=A1+B1”）

<h2 id="tools">配置</h2>

命令行参数

以下命令行参数可用：

--transport <type>   传输类型（stdio 或 sse）
--host <address>     SSE 传输监听的主机地址（默认：所有接口）
--port <number>      SSE 传输的端口（默认：8000）

使用示例：

npx @fbeawels/excel-mcp-server --transport sse --host 0.0.0.0 --port 8000

环境变量

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

EXCEL_MCP_PAGING_CELLS_LIMIT

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

EXCEL_MCP_TRANSPORT

用于通信的传输机制。 可能的值：stdio，sse [默认：stdio]

EXCEL_MCP_HOST

使用 SSE 传输时要绑定的主机地址。 [默认：""（所有接口）]

EXCEL_MCP_PORT

使用 SSE 传输时 HTTP 服务器使用的端口。 [默认：8000]

许可证

版权所有 (c) 2025 Franck Besnard

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