📊 Servidor MCP para archivos Excel con macros (.xlsm)

📊 用于宏 Excel 文件（.xlsm）的 MCP 服务

作者： Orlando Ospino (orlando2019)

此服务实现了 Model Context Protocol (MCP)，用于操作包含宏的 Excel 文件（.xlsm）。它使用 stdio 协议进行通信，因此可以轻松集成到 Claude Desktop、Cursor 或 Windsurf 等 MCP 客户端中。

🌟 什么是 MCP？

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

✨ 特性

• 创建和操作带宏的 Excel 文件（.xlsm）
• 读取和写入电子表格中的数据
• 管理工作表（创建、删除、重命名）
• 列出并获取 VBA 宏的信息
• 设置单元格区域的格式
• 兼容 Python 3.10+
• 可轻松集成到虚拟环境和现代 MCP 客户端中

🔧 安装

使用 pip

pip install xlsm-mcp-server

使用 uv（推荐）

uv venv
.venv\Scripts\activate
uv pip install -r requirements.txt

📝 使用方法

直接运行

python -m xlsm_mcp

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

.venv\Scripts\python.exe -m xlsm_mcp

配置 Claude Desktop、Cursor 或 Windsurf

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

"mcpServers": {
  "xlsm": {
    "command": "python",
    "args": ["-m", "xlsm_mcp"],
    "transport": "stdio"
  }
}

• 在某些客户端中可以省略 "transport": "stdio"，但建议保留，以确保最大兼容性。
• 如果使用虚拟环境，请将 "python" 替换为 Python 可执行文件的路径。

高级参数

你可以根据服务的要求，在 "args" 部分添加自定义参数，例如：

"args": ["-m", "xlsm_mcp", "--log-level", "DEBUG"]

🛠️ 可用工具

• 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 文件读取数据

# Ejemplo de uso para leer datos
result = await read_data_from_excel("ejemplo.xlsm", "Hoja1", "A1", "C10")
print(result["data"])

列出文件中的宏

# Ejemplo para listar macros
macros = await list_macros_in_workbook("ejemplo.xlsm")
for macro in macros["data"]:
    print(f"Macro: {macro['name']}")

📋 使用场景

此服务尤其适用于：

• 使用 AI 模型的数据分析师
• 行政任务自动化
• 生成和操作财务报告
• 将 AI 集成到基于 Excel 的工作流中

👥 参与贡献

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

👨‍💻 作者

由 Orlando Ospino 开发（@Orlando_Ospino）

📄 许可证

MIT