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

本项目的 MCP 服务器专为处理包含宏的 Excel 文件（.xlsm）而设计，借助 Model Context Protocol (MCP) 协议，可与语言模型无缝交互，显著拓展其在数据分析和办公自动化领域的应用能力。

🚀 快速开始

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

✨ 主要特性

• 创建和操作带有宏的 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: 在现有文件中添加新工作表
• get_workbook_metadata: 获取文件元数据，包括宏相关信息
• list_macros_in_workbook: 列出文件中的所有宏
• get_macro_details: 获取特定宏的详细信息
• 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)

📚 详细文档

什么是MCP？

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

📄 许可证

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

⚠️ 重要提示

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