xlsm-mcp-server | 通往MCP之路

📊 支持宏的 Excel 文件 MCP 服务器 (.xlsm)

作者: Orlando Ospino (orlando2019)

该服务器实现了 Model Context Protocol (MCP)，用于操作包含宏的 Excel 文件 (.xlsm)。它使用 stdio 协议进行通信，便于与 MCP 客户端（如 Claude Desktop、Cursor 或 Windsurf）集成。

🌟 什么是 MCP？

MCP（Model Context Protocol）是一种允许语言模型与外部工具交互的协议。通过此服务器，Claude 和其他 AI 助手可以原生地操作包含宏的 Excel 文件，从而扩展其在数据分析和办公自动化任务中的能力。

✨ 特性

创建和操作包含宏的 Excel 文件 (.xlsm)

读取和写入电子表格数据

管理工作表（创建、删除、重命名）

列出并获取 VBA 宏信息

应用单元格范围格式

兼容 Python 3.10+

轻松集成虚拟环境和现代 MCP 客户端

🔧 安装

使用 pip

使用 uv（推荐）

📝 使用

直接运行

或者，如果使用虚拟环境：

配置 Claude Desktop、Cursor 或 Windsurf

在配置文件中（例如 settings.json）添加：

在某些客户端中可以省略 "transport": "stdio"，但为了最大兼容性建议保留。

如果使用虚拟环境，将 "python" 替换为你的 Python 可执行文件路径。

高级参数

你可以在 "args" 部分添加自定义参数，例如：

🛠️ 可用工具

read_data_from_excel: 从 Excel 工作表中读取数据

write_data_to_excel: 向 Excel 工作表中写入数据

create_new_workbook: 创建新的 Excel 工作簿，可选择启用宏

create_new_worksheet: 在现有 Excel 工作簿中创建新工作表

get_workbook_metadata: 获取工作簿元数据，包括宏信息

list_macros_in_workbook: 列出工作簿中的所有宏

get_macro_details: 获取特定宏的详细信息

format_cell_range: 对单元格范围应用格式

💡 示例

从 Excel 文件中读取数据

列出文件中的宏

📋 使用场景

该服务器特别适用于：

使用 AI 模型的数据分析师

办公任务自动化

财务报告的生成和操作

将 AI 集成到基于 Excel 的工作流中

👥 贡献

欢迎贡献代码。请在仓库中提交 issue 或 pull request。

👨‍💻 作者

由 Orlando Ospino 开发 (@Orlando_Ospino)

📄 许可证

MIT