Excel MCP 服务器

简体中文| English

基于模型上下文协议（MCP）的Excel文件处理服务器，提供读取、写入和分析Excel文件的功能。

特征

• 📖 读取 Excel 文件

  • 获取工作表列表

  • 读取特定工作表数据

  • 读取所有工作表数据

• ✍️ 写入 Excel 文件

  • 创建新的 Excel 文件

  • 写入特定工作表

  • 支持多个工作表

• 🔍 分析 Excel 结构

  • 分析工作表结构

  • 将结构导出到新文件

• 💾 缓存管理

  • 自动文件内容缓存

  • 定期清理缓存

  • 手动清除缓存

• 📝 日志管理

  • 自动操作记录

  • 定期日志清理

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 excel-mcp-server：

手动安装

通过 NPM 安装 excel-mcp-server 可以通过在 MCP 服务器配置中添加以下配置来自动安装。

Windows 平台：

其他平台：

注意：LOG_PATH 是可选的。如果未设置，日志将存储在应用程序根目录下的“logs”文件夹中。其他参数是可选的。

API 工具

结构工具

1. 分析Excel结构

   • 功能：获取 JSON 格式的 Excel 文件结构，包括工作表列表和列标题

   • 参数：

     • fileAbsolutePath：Excel 文件的绝对路径

     • headerRows：标题行数（默认值：1）

2. 导出Excel结构

   • 功能：将Excel文件结构（工作表和标题）导出到新的Excel模板文件

   • 参数：

     • sourceFilePath：源 Excel 文件路径

     • targetFilePath：目标 Excel 文件路径

     • headerRows：标题行数（默认值：1）

阅读工具

1. 读取工作表名称

   • 功能：获取Excel文件中所有sheet名称

   • 参数：

     • fileAbsolutePath：Excel 文件的绝对路径

2. 通过工作表名称读取数据

   • 功能：获取Excel文件中特定sheet的数据

   • 参数：

     • fileAbsolutePath：Excel 文件的绝对路径

     • sheetName：要读取的工作表的名称

     • headerRow：标题行数（默认值：1）

     • dataStartRow：数据起始行号（默认：2）

3. 读取工作表数据

   • 功能：获取Excel文件中所有sheet的数据

   • 参数：

     • fileAbsolutePath：Excel 文件的绝对路径

     • headerRow：标题行数（默认值：1）

     • dataStartRow：数据起始行号（默认：2）

编写工具

1. 通过工作表名称写入数据

   • 功能：将数据写入Excel文件中的指定sheet（如果sheet存在则覆盖）

   • 参数：

     • fileAbsolutePath：Excel 文件的绝对路径

     • sheetName：要写入的工作表的名称

     • 数据：要写入的数据数组

2. 写入工作表数据

   • 功能：使用提供的数据创建一个新的 Excel 文件

   • 参数：

     • fileAbsolutePath：新 Excel 文件的绝对路径

     • data：包含多个 Sheet 数据的对象

缓存工具

1. 清除文件缓存

   • 功能：清除指定Excel文件的缓存数据

   • 参数：

     • fileAbsolutePath：要从缓存中清除的 Excel 文件的绝对路径

配置

环境变量

• LOG_PATH ：日志文件存储路径

  • 选修的

  • 默认值：应用程序根目录下的“logs”文件夹

• CACHE_MAX_AGE ：缓存过期时间（小时）

  • 选修的

  • 默认值：1

• CACHE_CLEANUP_INTERVAL ：缓存清理间隔（小时）

  • 选修的

  • 默认值：4

• LOG_RETENTION_DAYS ：日志保留天数

  • 选修的

  • 默认值：7

• LOG_CLEANUP_INTERVAL ：日志清理间隔（小时）

  • 选修的

  • 默认值：24

默认配置

• 缓存配置

  • 缓存过期时间：1小时

  • 缓存清理间隔：4小时

• 日志配置

  • 日志保留天数：7天

  • 清理间隔：24小时

依赖项

• @modelcontextprotocol/sdk: ^1.7.0

• xlsx: ^0.18.5

• 打字稿：^5.8.2

开发依赖项

• @类型/节点：^22.13.10

• nodemon：^3.1.9

• ts节点：^10.9.2

执照

本项目遵循 MIT 许可证。这意味着您可以自由地：

• 将该软件用于商业或非商业用途

• 修改源代码

• 分发原始或修改后的代码要求：

• 保留原有版权声明

• 对于软件使用，作者不承担任何责任。有关详细的许可信息，请参阅LICENSE文件。