Xlsm MCP Server

🚀 📊 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 或更高版本。
• 在虛擬環境中使用時，請激活環境後再運行。
• 對於複雜的宏文件，可能會出現性能問題，建議測試後優化。