🚀 Excel MCP 服务器
Excel MCP 服务器是一个强大的 Excel 文件处理工具，它支持对 Excel 文件的数据、公式和图像进行读取与写入操作。并且，该服务器可以通过标准输入输出（stdio）或基于 HTTP 的 Server-Sent Events（SSE）进行通信，为用户提供了灵活的使用方式。
]
🚀 快速开始
Excel MCP 服务器支持多种操作，如读取和写入 Excel 文件的数据、公式和图像。它能在 Windows 和类 Unix 系统（如 Linux、macOS）上运行，且需要安装 Node.js 和 npm。
✨ 主要特性
- 读取数据：从指定范围提取单元格内容。
- 读取公式：获取特定范围内的单元格公式。
- 读取图像：[Windows 系统] 从工作表中提取指定范围的图像数据。
- 写入数据：向 Excel 文件中的指定范围写入新的数据。
- 写入公式：在指定范围内写入新的公式。
📦 安装指南
使用 NPM 安装
- 安装依赖：
npm install @fbeawels/excel-mcp-server
- 运行服务器（可选参数）：
npx @fbeawels/excel-mcp-server [--transport stdio|sse] [--host <地址>] [--port <端口>]
使用 Smithery 安装
- 添加依赖到
package.json：
{
"dependencies": {
"@fbeawels/excel-mcp-server": "^1.0.0"
}
}
- 运行服务器（可选参数）：
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 文件了解具体流程。