Excel MCP 服务器

基于 Model Context Protocol (MCP) 的 Excel 文件处理服务器，提供读取、写入和分析 Excel 文件的功能。

特性

• 📖 读取 Excel 文件

  • 获取工作表列表
  • 读取特定工作表数据
  • 读取所有工作表数据

• ✍️ 写入 Excel 文件

  • 创建新 Excel 文件
  • 写入特定工作表
  • 支持多张工作表

• 🔍 分析 Excel 结构

  • 分析工作表结构
  • 导出结构到新文件

• 💾 缓存管理

  • 自动内容缓存
  • 定时缓存清理
  • 手动缓存清除

• 📝 日志管理

  • 自动操作日志记录
  • 定期日志清理

安装

通过 Smithery 安装

为了自动为 Claude Desktop 安装 excel-mcp-server，请访问 Smithery 并运行以下命令：

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

手动安装

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

Windows 平台：

{
  "mcpServers": {
    "excel": {
        "command": "cmd",
        "args": ["/c", "npx", "--yes", "@zhiweixu/excel-mcp-server"],
        "env": {
            "LOG_PATH": "[设置一个可访问的绝对路径]",
            "CACHE_MAX_AGE": "1",
            "CACHE_CLEANUP_INTERVAL": "4",
            "LOG_RETENTION_DAYS": "7",
            "LOG_CLEANUP_INTERVAL": "24"
        }
    }
}

其他平台：

{
  "mcpServers": {
    "excel": {
        "command": "npx",
        "args": ["--yes", "@zhiweixu/excel-mcp-server"],
        "env": {
            "LOG_PATH": "[设置一个可访问的绝对路径]",
            "CACHE_MAX_AGE": "1",
            "CACHE_CLEANUP_INTERVAL": "4",
            "LOG_RETENTION_DAYS": "7",
            "LOG_CLEANUP_INTERVAL": "24"
        }
    }
}

配置

环境变量

• 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
• typescript: ^5.8.2

开发依赖项

• @types/node: ^22.13.10
• nodemon: ^3.1.9
• ts-node: ^10.9.2

许可证

该项目采用 MIT License。这意味着你可以自由地：

• 用于商业或非商业用途

• 修改源代码

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

• 保留原始版权声明

• 不能对作者因软件使用而产生的责任进行索赔 有关详细许可信息，请参阅 LICENSE 文件。