Excel MCP Server

# Excel MCP Server 项目结构 ``` excel-mcp/ ├── README.md # 项目说明 ├── INSTALL.md # 详细安装和配置指南 ├── requirements.txt # Python依赖包 ├── config.json # 服务器配置文件 ├── server.py # 主服务器启动文件 ├── claude_desktop_config.json # Claude Desktop配置示例 │ ├── src/excel_mcp/ # 核心源码目录 │ ├── __init__.py # 包初始化文件 │ ├── server.py # MCP服务器核心实现 │ ├── config.py # 配置管理模块 │ ├── security.py # 安全验证模块 │ ├── file_manager.py # Excel文件管理模块 │ ├── data_processor.py # 数据处理器模块 │ └── sheet_operations.py # 工作表操作模块 │ ├── tests/ # 测试文件目录 │ └── test_excel_mcp.py # 主测试文件 │ ├── data/ # 数据文件目录 │ ├── sales_example.xlsx # 销售数据示例 │ ├── employee_example.xlsx # 员工数据示例 │ ├── test_excel.xlsx # 测试文件 │ └── mcp_test.xlsx # MCP测试文件 │ ├── temp/ # 临时文件目录 │ └── (备份文件) │ └── logs/ # 日志文件目录 └── excel_mcp.log # 服务器日志 ``` ## 核心组件说明 ### 1. 服务器核心 (server.py) - FastMCP服务器实现 - 12个MCP工具接口 - 组件初始化和管理 ### 2. 文件管理 (file_manager.py) - Excel文件读取/写入/创建 - 文件验证和备份 - pandas集成支持 ### 3. 数据处理 (data_processor.py) - 单元格范围读写 - 数据查询和筛选 - 公式计算和应用 ### 4. 工作表操作 (sheet_operations.py) - 创建/删除/重命名工作表 - 工作表信息获取 - 工作表复制和移动 ### 5. 安全模块 (security.py) - 文件路径验证 - 访问权限控制 - 文件大小限制 ### 6. 配置管理 (config.py) - 配置文件加载 - 默认配置管理 - 安全设置获取 ## 支持的MCP工具 1. `read_excel_file` - 读取Excel文件内容 2. `write_excel_file` - 写入数据到Excel文件 3. `create_excel_file` - 创建新的Excel文件 4. `query_excel_data` - 查询Excel数据 5. `get_excel_info` - 获取Excel文件信息 6. `create_worksheet` - 创建新工作表 7. `delete_worksheet` - 删除工作表 8. `rename_worksheet` - 重命名工作表 9. `apply_formula` - 应用Excel公式 10. `list_worksheets` - 列出所有工作表 11. `get_range_info` - 获取单元格范围信息 ## 安全特性 - 路径白名单验证 - 文件类型检查 - 文件大小限制 - 自动备份机制 - 错误日志记录 ## 已测试功能 ✅ Excel文件创建和读写 ✅ 数据查询和筛选 ✅ 工作表操作 ✅ 公式计算 ✅ MCP工具接口 ✅ 安全验证 ✅ 配置管理 ✅ 日志记录