Haris Musa Excel MCP Server

🚀 Excel MCP 服務器

Excel MCP 服務器是一個模型上下文協議（MCP）服務器，無需安裝 Microsoft Excel 即可操作 Excel 文件。藉助它，您可以使用 AI 代理輕鬆創建、讀取和修改 Excel 工作簿。

🚀 快速開始

先決條件

• Python 3.10 或更高版本

📦 安裝指南

1. 克隆倉庫：

git clone https://github.com/haris-musa/excel-mcp-server.git
cd excel-mcp-server

2. 使用 uv 進行安裝：

uv pip install -e .

運行服務器

啟動服務器（默認端口 8000）：

uv run excel-mcp-server

自定義端口（例如，8080）：

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

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

✨ 主要特性

• 📊 創建和修改 Excel 工作簿
• 📝 讀取和寫入數據
• 🎨 應用格式和樣式
• 📈 創建圖表和可視化
• 📊 生成透視表
• 🔄 管理工作表和範圍

💻 使用示例

與 AI 工具一起使用

Cursor IDE

1. 將以下配置添加到 Cursor：

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

2. Excel 工具將通過您的 AI 助手提供。

遠程託管 & 傳輸協議

此服務器使用 Server-Sent Events (SSE) 傳輸協議。針對不同用例：

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

📚 詳細文檔

環境變量

可用工具

該服務器提供全面的 Excel 操作工具。有關所有可用工具的完整文檔，請參閱 TOOLS.md。

📄 許可證

本項目採用 MIT License，詳細信息請查看 LICENSE。