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工具接口
✅ 安全验证
✅ 配置管理
✅ 日志记录