Spire Xls MCP Server

🚀 Spire.XLS MCP 服務器是什麼？

Spire.XLS MCP 服務器是一個強大的解決方案，它使 AI 代理能夠使用模型上下文協議（MCP）處理 Excel 文件。它完全獨立，無需在系統上安裝 Microsoft Office。藉助此工具，AI 代理可以無縫地創建、讀取、編輯和轉換 Excel 工作簿。

✨ 主要特性

• 高保真轉換：支持將 Excel 轉換為 PDF、Excel 轉換為 HTML、Excel 轉換為 CSV、Excel 轉換為圖像、Excel 轉換為 XML 等。
• 工作簿管理：能夠創建、修改和管理 Excel 工作簿。
• 工作表控制：可對工作表進行重命名、移動、隱藏、凍結窗格等操作。
• 數據管理：支持管理工作表和單元格區域，讀寫數據，分析 Excel 數據。
• 可視化操作：可添加各種圖表類型，根據數據創建可視化的 Excel 儀表盤。
• 數據透視：創建和操作數據透視表，以彙總、分析、探索和展示 Excel 數據。

📦 安裝指南

前置條件

• Python 3.10 或更高版本

安裝步驟

1. 克隆倉庫：

git clone https://github.com/eiceblue/spire-xls-mcp-server.git
cd spire-xls-mcp-server

2. 使用 uv 進行安裝：

uv pip install -e .

啟動服務器

• 默認端口（8000）啟動：

uv run spire-xls-mcp-server

• 自定義端口（如 8080）啟動：

# Bash/Linux/macOS
export FASTMCP_PORT=8080 && uv run spire-xls-mcp-server

# Windows PowerShell
$env:FASTMCP_PORT = "8080"; uv run spire-xls-mcp-server

🚀 快速開始

與 AI 工具集成

Cursor IDE

1. 在 Cursor 中添加以下配置：

{
  "mcpServers": {
    "excel": {
      "url": "http://localhost:8000/sse",
      "env": {
        "EXCEL_FILES_PATH": "/path/to/excel/files"
      }
    }
  }
}

2. 通過 AI 助手即可使用 Excel 工具。

遠程託管與傳輸協議

本服務器使用服務器發送事件（SSE）傳輸協議。針對不同使用場景：

1. 與 Claude Desktop 配合使用（需要 stdio）：
   • 使用 Supergateway 將 SSE 轉換為 stdio。
2. 託管自己的 MCP 服務器：
   • 參考 遠程 MCP 服務器指南。

📚 詳細文檔

環境變量

可用工具

服務器提供了一套全面的 Excel 操作工具，主要分類如下：

• 基本操作：創建、讀取、寫入和刪除 Excel 工作表或工作簿。
• 數據處理：讀寫單元格數據、應用公式、排序和過濾。
• 格式設置：應用樣式、合併單元格、設置字體和顏色。
• 高級功能：創建圖表、數據透視表、條件格式設置。
• 文件轉換：高保真地將 Excel 轉換為 PDF、HTML、CSV、圖像、XML 等。

完整的工具文檔請參考 TOOLS.md。

常見問題解答

Q1. 我可以在任何目錄中使用 Spire.XLS MCP 服務器嗎？ A1. 可以，Spire.XLS MCP 服務器可在任何目錄中使用。

Q2. Spire.XLS MCP 服務器是否免費使用？ A2. 是的，它遵循 MIT 許可證，允許免費使用和修改。

Q3. Spire.XLS MCP 服務器支持哪些編程語言？ A3. 它是用 Python 構建的。

📄 許可證

本項目採用 MIT 許可證。