JinDaGe - excel-mcp-server MCP Details

article

README

🚀 Excel MCP 服务器

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

🚀 快速开始

本服务器基于 Model Context Protocol (MCP)，能实现 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 文件。

excel-mcp-server