Xlsm MCP Server

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

此服务器实现了Model Context Protocol (MCP)，专门用于处理带有宏的Excel文件（.xlsm）。它借助stdio协议进行通信，能够轻松集成到Claude Desktop、Cursor或Windsurf等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"]

✨ 主要特性

• 创建和操作带有 macros 的 Excel 文件 (.xlsm)
• 读取和写入工作表数据
• 管理工作表（创建、删除、重命名）
• 列出并获取 VBA 宏的信息
• 应用单元格范围格式
• 兼容 Python 3.10+
• 轻松集成到虚拟环境和现代 MCP 客户端

💻 使用示例

基础用法

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

高级用法

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

📚 详细文档

🛠️ 可用工具

• 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: 应用格式到单元格范围

📄 许可证

文档未提及相关内容，跳过该章节。

⚠️ 重要提示

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

作者: Orlando Ospino (orlando2019)