Excel MCP服务器
简体中文 |英语
基于模型上下文协议（MCP）的Excel文件处理服务器，提供读取、写入和分析Excel文件的功能。
特性
- 📖 读取Excel文件
- 获取工作表列表 - 读取特定工作表数据 - 读取所有工作表数据
- ✍️ 编写Excel文件
- 创建新的Excel文件 - 写入特定工作表 - 支持多个工作表
- 🔍 分析Excel结构
- 分析工作表结构 - 将结构导出到新文件
- 💾 缓存管理
- 自动文件内容缓存 - 计划缓存清理 - 手动清除缓存
- 📝 日志管理
- 自动操作日志记录 - 定期日志清理
安装
通过Smithery安装
通过以下方式自动安装Claude Desktop的excel mcp服务器 史密瑟里:
npx -y @smithery/cli install @zhiwei5576/excel-mcp-server --client claude手动安装
通过NPM安装 通过将以下配置添加到mcp服务器配置中，可以自动安装excelmcp服务器。
Windows平台：
{
"mcpServers": {
"excel": {
"command": "cmd",
"args": ["/c", "npx", "--yes", "@zhiweixu/excel-mcp-server"],
"env": {
"LOG_PATH": "[set an accessible absolute 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": "[set an accessible absolute path]",
"CACHE_MAX_AGE": "1",
"CACHE_CLEANUP_INTERVAL": "4",
"LOG_RETENTION_DAYS": "7",
"LOG_CLEANUP_INTERVAL": "24"
}
}
}注意：LOG_PATH是可选的。如果未设置，日志将存储在应用程序根目录下的“logs”文件夹中。其他参数是可选的。
API工具
结构工具
- 分析ExcelStructure
- 功能：获取Excel文件结构，包括JSON格式的表列表和列标题 - 参数： - fileAbsolutePath：Excel文件的绝对路径 - headerRows：标题行数（默认值：1）
- ExportExcelStructure
- 功能：将Excel文件结构（工作表和标题）导出到新的Excel模板文件 - 参数： - sourceFilePath:源Excel文件路径 - targetFilePath:目标Excel文件路径 - headerRows：标题行数（默认值：1）
阅读工具
- readSheetNames
- 功能：从Excel文件中获取所有工作表名称 - 参数： - fileAbsolutePath：Excel文件的绝对路径
- readDataBySheet
- 功能：从Excel文件中的特定工作表获取数据 - 参数： - fileAbsolutePath：Excel文件的绝对路径 - sheetName：要读取的表的名称 - headerRow：表头行号（默认值：1） - dataStartRow：数据起始行号（默认值：2）
- readSheetData
- 功能：从Excel文件中的所有工作表中获取数据 - 参数： - fileAbsolutePath：Excel文件的绝对路径 - headerRow：表头行号（默认值：1） - dataStartRow：数据起始行号（默认值：2）
写入工具
- writeDataBySheet
- 功能：将数据写入Excel文件中的特定工作表（如果工作表存在，则覆盖） - 参数： - fileAbsolutePath：Excel文件的绝对路径 - sheetName：要写入的表的名称 - data:要写入的数据数组
- writeSheetData
- 功能：使用提供的数据创建新的Excel文件 - 参数： - fileAbsolutePath：新Excel文件的绝对路径 - data:包含多张图纸数据的对象
缓存工具
- 清除文件缓存
- 功能：清除指定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
- 节点号：^3.1.9
- ts节点：^10.9.2
许可证
该项目根据MIT许可证获得许可。这意味着您可以自由地：
- 将软件用于商业或非商业目的
- 修改源代码
- 分发原始或修改后的代码
要求：
- 保留原始版权声明
- 不得就软件使用向作者索赔任何责任
有关详细的许可证信息，请参阅 许可证 文件。