📊 MCP服务器用于Excel文件（含宏）(.xlsm)

作者: Orlando Ospino (orlando2019)

此服务器实现Model Context Protocol (MCP) 用于处理带有 macros 的 Excel 文件 (.xlsm)。它使用 stdio 协议进行通信，因此可以轻松集成到如 Claude Desktop、Cursor 或 Windsurf 等 MCP 客户端中。

🌟 什么是MCP？

MCP（Model Context Protocol）是一种协议，允许语言模型与其外部工具交互。通过此服务器，Claude 和其他 AI 助手可以自然地处理带有 macros 的 Excel 文件，扩展其在数据分析和办公室自动化任务中的能力。

✨ 特性

• 创建和操作带有 macros 的 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: 创建新的带 macros 支持的 Excel 文件
• create_new_worksheet: 在现有文件中添加新工作表
• get_workbook_metadata: 获取文件元数据，包括 macros 相关信息
• list_macros_in_workbook: 列出文件中的所有 macros
• get_macro_details: 获取特定 macro 的详细信息
• format_cell_range: 应用格式到单元格范围

💡 示例

从 Excel 文件读取数据

# 示例代码：从 Excel 文件读取数据
import xlsm_mcp as mcp
mcp.read_data_from_excel("example.xlsx")

将数据写入 Excel 工作表

# 示例代码：将数据写入 Excel 工作表
import xlsm_mcp as mcp
data = {
    "A": [1, 2, 3],
    "B": ["a", "b", "c"]
}
mcp.write_data_to_excel("example.xlsx", data)

📋 注意事项

• 确保你已安装 Python 3.10 或更高版本
• 在虚拟环境中使用时，请激活环境后再运行
• 对于复杂的 macros 文件，可能会出现性能问题，建议测试后优化

希望以上内容对你有所帮助！如果有任何问题，请随时联系作者。