Excel MCP 服务器

[]

简介

Excel MCP 服务器是一个用于处理 Excel 文件的工具，支持读取和写入数据、公式以及图像。它可以通过标准输入输出（stdio）或基于 HTTP 的 Server-Sent Events（SSE）进行通信。

功能

• 读取数据：从指定范围提取单元格内容。
• 读取公式：获取特定范围内的单元格公式。
• 读取图像：[Windows 系统] 从工作表中提取指定范围的图像数据。
• 写入数据：向 Excel 文件中的指定范围写入新的数据。
• 写入公式：在指定范围内写入新的公式。

要求

• 操作系统：支持 Windows 和类 Unix 系统（如 Linux、macOS）。
• Node.js 版本：需要安装 Node.js 和 npm。

安装方法

使用 NPM 安装

1. 安装依赖：

npm install @fbeawels/excel-mcp-server

2. 运行服务器（可选参数）：

npx @fbeawels/excel-mcp-server [--transport stdio|sse] [--host <地址>] [--port <端口>]

使用 Smithery 安装

1. 添加依赖到 package.json：

{
  "dependencies": {
    "@fbeawels/excel-mcp-server": "^1.0.0"
  }
}

2. 运行服务器（可选参数）：

npx @fbeawels/excel-mcp-server [--transport stdio|sse] [--host <地址>] [--port <端口>]

工具说明

读取数据

从 Excel 文件中读取指定范围的数据。

用法：

{
  "action": "readData",
  "params": {
    "file": "<文件路径>",
    "sheet": "<工作表名称>",
    "range": "<单元格范围>"
  }
}

读取公式

从 Excel 文件中读取指定范围的公式。

用法：

{
  "action": "readFormula",
  "params": {
    "file": "<文件路径>",
    "sheet": "<工作表名称>",
    "range": "<单元格范围>"
  }
}

读取图像

[Windows 系统] 从 Excel 文件中提取指定范围的图像数据。

用法：

{
  "action": "readImage",
  "params": {
    "file": "<文件路径>",
    "sheet": "<工作表名称>",
    "range": "<单元格范围>"
  }
}

写入数据

向 Excel 文件中的指定范围写入新的数据。

用法：

{
  "action": "writeData",
  "params": {
    "file": "<文件路径>",
    "sheet": "<工作表名称>",
    "range": "<单元格范围>",
    "data": "<要写入的数据>"
  }
}

写入公式

在 Excel 文件的指定范围内写入新的公式。

用法：

{
  "action": "writeFormula",
  "params": {
    "file": "<文件路径>",
    "sheet": "<工作表名称>",
    "range": "<单元格范围>",
    "formulas": "<要写入的公式>"
  }
}

配置

命令行参数

支持以下命令行参数：

• --transport <类型>：设置传输方式，可选值为 stdio 或 sse。
• --host <地址>：设置 SSE 传输时绑定的主机地址，默认为所有接口。
• --port <端口>：设置 SSE 传输时使用的端口号，默认为 8000。

示例用法：

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

环境变量

通过以下环境变量可以调整服务器行为：

• EXCEL_MCP_PAGING_CELLS_LIMIT：设置单次读取的最大单元格数量，默认为 4000。
• EXCEL_MCP_TRANSPORT：设置传输方式，可选值为 stdio 或 sse，默认为 stdio。
• EXCEL_MCP_HOST：设置 SSE 传输时绑定的主机地址，默认为空字符串（所有接口）。
• EXCEL_MCP_PORT：设置 SSE 传输时使用的端口号，默认为 8000。

许可证

本项目使用 MIT 许可证，详见 LICENSE 文件。

贡献指南

欢迎提交问题和贡献！请参考 CONTRIBUTING.md 文件了解具体流程。