这个项目能做什么

Excel MCP Server 是一个 Model Context Protocol 服务器,让 AI 助手能够创建、读取和编辑 Excel 工作簿。它不需要安装 Microsoft Excel。它支持 .xlsx、.xlsm(保留宏)、.xltx 和 .xltm 文件。 功能 - 读取和写入单元格、公式和日期,支持大型工作表分页和单元格搜索。 - 设置字体、填充、边框、数字格式、列宽和冻结窗格。 - 管理结构:工作表、行和列、合并单元格、表格、图表和汇总表。 - 应用规则:条件格式和数据验证,例如下拉列表和数字限制。 - 按模块读取 .xlsm 文件中的 VBA 代码(只读,绝不执行)。 安全功能 - 通过 --allow-dir 或 EXCEL_FILES_PATH 可选的文件夹限制;相对路径在允许的文件夹内解析。 - 公式安全检查会拒绝访问网络、其他程序或主机信息的函数(例如 WEBSERVICE、HYPERLINK、IMAGE、RTD、CALL、INFO、INDIRECT)、DDE 链接和外部工作簿引用。 - 只读模式、最大文件大小(默认 100 MB)、每次调用 100,000 个单元格的限制,以及原子保存。 - HTTP 模式默认监听 localhost;远程访问需要 bearer token,并建议使用终止 TLS 的反向代理。 设置 客户端通常使用 uvx excel-mcp-server stdio 运行服务器,可选带 --allow-dir。已记录的集成包括 Claude Desktop(包括 .mcpb 包)、Claude Code、Cursor、带 GitHub Copilot 的 VS Code、OpenAI Codex、Gemini CLI 和 Devin Desktop。提供 Streamable HTTP 模式,并支持 Docker。 工具领域包括工作簿(创建、描述、列出、导出、导入)、工作表(描述、创建、重命名、复制、删除、插入/删除行或列)、单元格(read_range、write_range、clear_range、copy_range、find_cells)、格式(format_range、merge_cells、set_sheet_layout、add_conditional_format、add_data_validation)、对象(create_table、create_chart、create_summary_table)和宏(read_vba)。 限制 - 公式只是存储,不会计算;values 模式返回 Excel 上次保存的结果,因此新写入的公式在 Excel 或 LibreOffice 中打开并保存之前会读取为空。 - 不支持旧版 .xls 和 .csv 文件。 - create_summary_table 写入静态汇总;不会创建真正的数据透视表。 - 插入或删除行和列不会更新引用被移动单元格的公式、图表或表格。 - openpyxl 不理解的特性,例如形状、切片器和某些嵌入对象,在编辑时可能会丢失;.xlsm 文件中的图片、图表、表格和宏会保留。 1.0 版本重命名并重新设计了工具,移除了 SSE 传输,并要求 Python 3.11 或更高版本。采用 MIT 许可证。