Excel

🚀 Excel MCP 服務端

一個基於 Model Context Protocol (MCP) 的服務端實現，無需安裝 Microsoft Excel 即可操作 Excel 文件，支持工作簿創建、數據處理、格式設置等高級功能。

🚀 快速開始

環境配置

服務端可以通過以下環境變量進行配置：

• EXCEL_FILES_PATH：存儲 Excel 文件的目錄（默認：./excel_files）

您可以通過以下方式設置：

• Windows CMD：

set EXCEL_FILES_PATH=C:\path\to\excel\files
uv run excel-mcp-server

• Windows PowerShell：

$env:EXCEL_FILES_PATH="C:\path\to\excel\files"
uv run excel-mcp-server

• Linux/MacOS：

export EXCEL_FILES_PATH=/path/to/excel/files
uv run excel-mcp-server

• Claude Desktop 配置：

{
  "mcpServers": {
    "excel": {
      "command": "uv run excel-mcp-server",
      "transport": "sse",
      "env": {
        "EXCEL_FILES_PATH": "/path/to/excel/files"
      }
    }
  }
}

啟動服務端

啟動服務端：

uv run excel-mcp-server

服務端將以 SSE 模式啟動並等待來自 MCP 客戶端的連接。

在 Cursor IDE 中連接

啟動服務端後，在 Cursor IDE 中連接到 SSE 終點：

http://localhost:8000/sse

Excel MCP 工具將在代理中可用。有關可用工具及其用法，請參閱 TOOLS.md。

✨ 主要特性

• 完整的 Excel 支持：提供全面的 Excel 功能。
• 數據操作：支持讀取、寫入和轉換數據。
• 高級功能：涵蓋圖表、數據透視表和格式設置。
• 錯誤處理：具備全面的錯誤處理和清晰的消息提示。

📦 安裝指南

要求

• Python 3.10+
• MCP SDK 1.2.0+
• OpenPyXL 3.1.2+

💻 使用示例

基礎用法

在不同系統環境下配置 EXCEL_FILES_PATH 並啟動服務端：

# Windows CMD
set EXCEL_FILES_PATH=C:\path\to\excel\files
uv run excel-mcp-server

# Windows PowerShell
$env:EXCEL_FILES_PATH="C:\path\to\excel\files"
uv run excel-mcp-server

# Linux/MacOS
export EXCEL_FILES_PATH=/path/to/excel/files
uv run excel-mcp-server

高級用法

在 Claude Desktop 配置中設置服務端環境變量：

{
  "mcpServers": {
    "excel": {
      "command": "uv run excel-mcp-server",
      "transport": "sse",
      "env": {
        "EXCEL_FILES_PATH": "/path/to/excel/files"
      }
    }
  }
}

📚 詳細文檔

組件

資源

該服務端通過 OpenPyXL 提供 Excel 工作簿操作功能：

• 創建和修改 Excel 工作簿
• 管理工作表和範圍
• 處理格式設置和樣式
• 支持圖表和數據透視表

工具

此服務端提供全面的 Excel 操作工具。有關所有可用工具、參數和使用示例的詳細文檔，請參閱 TOOLS.md。 工具包括以下功能：

• 工作簿和工作表管理
• 數據讀取和寫入
• 格式設置和樣式處理
• 圖表和可視化
• 數據透視表和數據分析

請參考 TOOLS.md 瞭解完整文檔。

📄 許可證

此項目在 MIT License 下許可 - 請查看 LICENSE 文件以獲取詳細信息。