Excel MCP Server

🚀 Excel MCP 服務器

Excel MCP 服務器是基於 Model Context Protocol (MCP) 的 Excel 文件處理服務器，可提供讀取、寫入和分析 Excel 文件的功能，為 Excel 數據處理提供便利。

🚀 快速開始

本服務器基於 Model Context Protocol (MCP)，能實現 Excel 文件的讀取、寫入與分析。若要快速體驗，可參考後續的安裝和使用說明。

✨ 主要特性

• 📖 讀取 Excel 文件

  • 獲取工作表列表
  • 讀取特定工作表數據
  • 讀取所有工作表數據

• ✍️ 寫入 Excel 文件

  • 創建新 Excel 文件
  • 寫入特定工作表
  • 支持多張工作表

• 🔍 分析 Excel 結構

  • 分析工作表結構
  • 導出結構到新文件

• 💾 緩存管理

  • 自動內容緩存
  • 定時緩存清理
  • 手動緩存清除

• 📝 日誌管理

  • 自動操作日誌記錄
  • 定期日誌清理

📦 安裝指南

通過 Smithery 安裝

為了自動為 Claude Desktop 安裝 excel-mcp-server，請訪問 Smithery 並運行以下命令：

npx -y @smithery/cli install @zhiweixu/excel-mcp-server --client claude

手動安裝

通過 NPM 安裝，excel-mcp-server 可以自動安裝，只需在 MCP 服務器配置中添加以下內容。

Windows 平臺：

{
  "mcpServers": {
    "excel": {
        "command": "cmd",
        "args": ["/c", "npx", "--yes", "@zhiweixu/excel-mcp-server"],
        "env": {
            "LOG_PATH": "[設置一個可訪問的絕對路徑]",
            "CACHE_MAX_AGE": "1",
            "CACHE_CLEANUP_INTERVAL": "4",
            "LOG_RETENTION_DAYS": "7",
            "LOG_CLEANUP_INTERVAL": "24"
        }
    }
}

其他平臺：

{
  "mcpServers": {
    "excel": {
        "command": "npx",
        "args": ["--yes", "@zhiweixu/excel-mcp-server"],
        "env": {
            "LOG_PATH": "[設置一個可訪問的絕對路徑]",
            "CACHE_MAX_AGE": "1",
            "CACHE_CLEANUP_INTERVAL": "4",
            "LOG_RETENTION_DAYS": "7",
            "LOG_CLEANUP_INTERVAL": "24"
        }
    }
}

📚 詳細文檔

配置

環境變量

• LOG_PATH：日誌文件存儲路徑，可選，默認是應用程序根目錄下的 'logs' 文件夾。
• CACHE_MAX_AGE：緩存過期時間（小時），可選，默認值為 1。
• CACHE_CLEANUP_INTERVAL：緩存清理間隔（小時），可選，默認值為 4。
• LOG_RETENTION_DAYS：日誌保留天數，可選，默認值為 7。
• LOG_CLEANUP_INTERVAL：日誌清理間隔（小時），可選，默認值為 24。

默認配置

• 緩存配置

  • 緩存過期時間：1 小時
  • 緩存清理間隔：4 小時

• 日誌配置

  • 日誌保留天數：7 天
  • 清理間隔：24 小時

依賴項

開發依賴項

📄 許可證

該項目採用 MIT License。這意味著你可以自由地：

• 用於商業或非商業用途
• 修改源代碼
• 分發原始或修改後的代碼

要求：

• 保留原始版權聲明
• 不能對作者因軟件使用而產生的責任進行索賠

有關詳細許可信息，請參閱 LICENSE 文件。