Uses Mermaid diagrams to visualize the system architecture and data flow of the Excel MCP server.
Utilizes pandas for data analysis and processing operations within Excel files, enabling advanced data manipulation and querying capabilities.
Built on Python platform to provide Excel file processing capabilities including reading, writing, formula calculation, and worksheet management.
Excel MCP Server
🚀 基于Model Context Protocol (MCP)的Excel处理服务器,使AI助手能够读取、写入和操作Excel文件。
✨ 功能特性
- 📊 Excel文件操作: 支持读取、写入和创建Excel文件 (.xlsx, .xls, .csv)
- 🔍 数据查询: 高级数据查询和筛选功能
- ✏️ 单元格操作: 数据修改和格式设置
- 📋 工作表管理: 创建、删除、重命名工作表
- 🧮 公式计算: 支持Excel公式的应用和计算
- 📈 基础图表: 图表创建和操作
- 🛡️ 安全机制: 路径验证、文件大小限制、自动备份
- 🎨 数据格式化: 丰富的单元格格式设置选项
🏗️ 系统架构
🚀 快速开始
1. 环境要求
- Python 3.10 或更高版本
- pip 包管理器
2. 安装依赖
3. 启动服务器
4. 配置Claude Desktop
在Claude Desktop的配置文件中添加以下配置:
🛠️ 支持的操作
📁 文件操作
read_excel_file
- 读取Excel文件内容write_excel_file
- 写入数据到Excel文件create_excel_file
- 创建新的Excel文件get_excel_info
- 获取Excel文件信息
📊 数据操作
query_excel_data
- 查询Excel数据get_range_info
- 获取单元格范围信息apply_formula
- 应用Excel公式
📋 工作表操作
list_worksheets
- 列出所有工作表create_worksheet
- 创建新工作表delete_worksheet
- 删除工作表rename_worksheet
- 重命名工作表
💡 使用示例
读取Excel文件
创建新文件
数据查询
应用公式
🔧 配置选项
服务器配置通过 config.json
文件管理:
🧪 测试
运行测试套件:
📁 项目结构
🛡️ 安全特性
- 路径验证: 防止目录遍历攻击
- 文件类型检查: 仅允许指定的Excel格式
- 文件大小限制: 防止内存耗尽
- 访问权限控制: 限制可访问的目录
- 自动备份: 修改文件前自动创建备份
- 详细日志: 完整的操作和错误日志
🤝 贡献指南
我们欢迎所有形式的贡献!请查看 贡献指南 了解详情。
开发环境设置
- Fork 这个仓库
- 创建你的特性分支 (
git checkout -b feature/AmazingFeature
) - 提交你的更改 (
git commit -m 'Add some AmazingFeature'
) - 推送到分支 (
git push origin feature/AmazingFeature
) - 打开一个 Pull Request
📄 许可证
这个项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
🙏 致谢
- Model Context Protocol - 提供了优秀的MCP协议
- openpyxl - 强大的Excel文件处理库
- pandas - 数据分析和处理工具
📞 支持
如果你遇到任何问题或有疑问,请:
⭐ 如果这个项目对你有帮助,请给它一个星标!
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Enables AI assistants to read, write, and manipulate Excel files through comprehensive spreadsheet operations. Supports file management, data querying, worksheet operations, formula calculations, and includes security features like path validation and automatic backups.