ExcelForge

ExcelForge 是一个基于 MCP (Model Context Protocol) 的 Excel 操作工具集，让 AI 助手能够安全、高效地操作 Excel 文件。

功能特性

• 工作簿管理 - 打开、保存、关闭 Excel 文件
• 工作表操作 - 创建、删除、重命名、查看结构
• 范围操作 - 读写数据、复制、清除、排序
• 公式支持 - 验证表达式、填充范围
• 格式设置 - 设置单元格样式、自动调整列宽
• 备份恢复 - 文件级备份、快照回滚
• VBA 只读访问 - 查看工程和模块代码
• 命名范围 - 列出和读取命名区域
• 数据验证和条件格式 - 读取工作表规则

版本

当前版本: 0.5.0

系统要求

• Windows 操作系统
• Microsoft Excel (已安装)
• Python 3.11+
• pywin32

安装

pip install -e .

配置

编辑 config.yaml 文件配置：

• server.version - 服务器版本
• excel.visible - Excel 是否可见
• paths.allowed_roots - 允许访问的目录
• paths.allowed_extensions - 允许打开的文件扩展名
• limits.* - 各种操作限制

使用

# 启动服务器
python -m excelforge serve

# 查看帮助
python -m excelforge --help

工具列表

服务器启动后会注册以下工具（共 45 个）：

工作簿工具

• workbook.open_file - 打开 Excel 文件
• workbook.list_open - 列出已打开的工作簿
• workbook.get_info - 获取工作簿信息
• workbook.save_file - 保存工作簿
• workbook.close_file - 关闭工作簿
• workbook.create_file - 创建新工作簿

工作表工具

• sheet.inspect_structure - 检查工作表结构
• sheet.create_sheet - 创建工作表
• sheet.rename_sheet - 重命名工作表
• sheet.preview_delete - 预览删除
• sheet.delete_sheet - 删除工作表
• sheet.set_auto_filter - 设置自动筛选
• sheet.get_conditional_formats - 获取条件格式
• sheet.get_data_validations - 获取数据验证

范围工具

• range.read_values - 读取范围值
• range.write_values - 写入范围值
• range.clear_contents - 清除范围内容
• range.copy_range - 复制范围
• range.insert_rows - 插入行
• range.delete_rows - 删除行
• range.insert_columns - 插入列
• range.delete_columns - 删除列
• range.sort_data - 排序数据
• range.merge_cells - 合并单元格
• range.unmerge_cells - 取消合并单元格

公式工具

• formula.validate_expression - 验证公式
• formula.fill_range - 填充公式

格式工具

• format.set_range_style - 设置范围样式
• format.auto_fit_columns - 自动调整列宽

回滚工具

• rollback.list_snapshots - 列出快照
• rollback.preview_snapshot - 预览快照
• rollback.restore_snapshot - 恢复快照

快照工具

• snapshot.get_stats - 获取快照统计
• snapshot.run_cleanup - 运行清理

审计工具

• audit.list_operations - 列出操作记录

VBA 工具

• vba.inspect_project - 检查 VBA 工程
• vba.get_module_code - 获取模块代码
• vba.scan_code - 扫描 VBA 代码
• vba.sync_module - 同步 VBA 模块
• vba.remove_module - 删除 VBA 模块

备份工具

• backup.list_backups - 列出备份
• backup.restore_file - 恢复备份文件

命名范围工具

• named_range.list_ranges - 列出命名范围
• named_range.read_values - 读取命名范围值

服务器工具

• server.get_status - 获取服务器状态