MCP Excel Server

🚀 Excel MCP 服務器

Excel MCP 服務器是一個強大的工具，它提供了全面的 Excel 文件管理和數據分析功能，能幫助用戶高效地處理和分析 Excel 數據。

🚀 快速開始

Excel MCP 服務器為用戶提供了便捷的 Excel 文件管理與數據分析能力。通過它，用戶可以輕鬆完成文件操作、數據分析和可視化等任務。

✨ 主要特性

• Excel 文件操作
  • 支持讀取多種 Excel 格式，如 XLSX、XLS、CSV、TSV、JSON，滿足不同數據源的需求。
  • 可進行寫入和更新 Excel 文件的操作，方便數據的修改和保存。
  • 能夠獲取文件信息和工作表名稱，便於瞭解文件結構。
• 數據分析
  • 提供彙總統計和描述性分析功能，幫助用戶快速瞭解數據特徵。
  • 進行數據質量評估，確保數據的準確性和可靠性。
  • 支持創建數據透視表，方便對數據進行多維度分析。
  • 可根據條件進行數據篩選和查詢，精準定位所需數據。
• 可視化
  • 能根據 Excel 數據生成圖表和圖形，直觀展示數據關係。
  • 創建數據預覽，讓用戶快速瞭解數據概況。
  • 支持將可視化結果導出為圖片，方便分享和展示。

📦 安裝指南

1. 創建一個新的 Python 環境（推薦）：

# 使用 uv（推薦）
uv init excel-mcp-server
cd excel-mcp-server
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 或使用 pip
python -m venv .venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

2. 安裝依賴項：

# 使用 uv
uv pip install -r requirements.txt

# 或使用 pip
pip install -r requirements.txt

📚 詳細文檔

集成到 Claude Desktop

1. 安裝 Claude Desktop
2. 打開設置並轉到開發者選項卡
3. 編輯 claude_desktop_config.json：

{
  "mcpServers": {
      "command": "uvx",
      "args": [
        "mcp-excel-server"
      ],
      "env": {
        "PYTHONPATH": "/path/to/your/python"
      }
  }
}

可用工具

文件讀取

• read_excel：讀取 Excel 文件
• get_excel_info：獲取文件詳細信息
• get_sheet_names：列出工作表名稱

數據分析

• analyze_excel：執行統計分析
• filter_excel：按條件篩選數據
• pivot_table：創建數據透視表
• data_summary：生成全面的數據摘要

數據可視化

• export_chart：生成圖表，支持的圖表類型包括折線圖、柱狀圖、散點圖和直方圖

文件操作

• write_excel：寫入新的 Excel 文件
• update_excel：更新現有 Excel 文件

可用資源

• excel://{file_path}：獲取文件內容
• excel://{file_path}/info：獲取文件結構信息
• excel://{file_path}/preview：生成數據預覽圖片

提示模板

• analyze_excel_data：用於 Excel 數據分析的引導式模板
• create_chart：幫助創建數據可視化
• data_cleaning：協助進行數據清理

💻 使用示例

基礎用法

以下是一些常見的使用示例：

• “分析我的 sales_data.xlsx 文件”
• “為 product_sales.csv 創建柱狀圖”
• “篩選 employees.xlsx 中年齡超過 30 歲的員工”
• “生成部門銷售額的透視表”

⚠️ 重要提示

• 只從指定路徑讀取文件
• 限制文件大小
• 防止意外文件覆蓋
• 嚴格控制數據轉換操作

🔧 技術細節

本服務器依賴於以下 Python 庫來實現各項功能：

📄 許可證

本項目採用 MIT License 進行許可。