Negokaz Excel MCP Server

🚀 Excel MCP 服務器

一個支持 Model Context Protocol (MCP) 的服務器，用於讀取和寫入 Microsoft Excel 數據，為 Excel 數據處理提供便捷方案。

🚀 快速開始

Excel MCP 服務器是一個支持 Model Context Protocol (MCP) 的服務器，可用於讀取和寫入 Microsoft Excel 數據。

✨ 主要特性

• 從 MS Excel 文件中讀取文本值
• 向 MS Excel 文件中寫入文本值
• 從 MS Excel 文件中讀取公式
• 向 MS Excel 文件中寫入公式
• 捕獲文件的屏幕圖像（僅限 Windows）

更多細節請參見工具部分。

📦 安裝指南

系統要求

• Node.js 20.x 或更高版本

支持的文件格式

• xlsx（Excel 工作簿）
• xlsm（帶宏的 Excel 工作簿）
• xltx（Excel 模板）
• xltm（帶宏的 Excel 模板）

安裝方法

通過 NPM 安裝

要自動安裝 Excel MCP Server，請在 MCP 服務器配置中添加以下內容。

對於 Windows：

{
    "mcpServers": {
        "excel": {
            "command": "cmd",
            "args": ["/c", "npx", "--yes", "@negokaz/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
            }
        }
    }
}

對於其他平臺：

{
    "mcpServers": {
        "excel": {
            "command": "npx",
            "args": ["--yes", "@negokaz/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
            }
        }
    }
}

通過史密瑟裡安裝

要自動為 Claude Desktop 安裝 Excel MCP Server，請使用 史密瑟裡：

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

📚 詳細文檔

read_sheet_names

列出 Excel 文件中的所有工作表名稱。

參數：

• fileAbsolutePath
  • Excel 文件的絕對路徑

read_sheet_data

按分頁讀取 Excel 工作表的數據。

參數：

• fileAbsolutePath
  • Excel 文件的絕對路徑
• sheetName
  • Excel 文件中的工作表名稱
• range（可選）
  • 讀取的範圍，格式為 "A1:B2"。
  • 默認值：整個工作表
• returnHeaders（可選）
  • 是否返回列標題，默認為 true。

read_sheet_data_all

按分頁讀取 Excel 文件中所有工作表的數據。

參數：

• fileAbsolutePath
  • Excel 文件的絕對路徑

write_sheet_data

向 Excel 工作表寫入數據。

參數：

• fileAbsolutePath
  • Excel 文件的絕對路徑
• sheetName
  • 要寫入的工作表名稱
• data
  • 要寫入的數據，格式為 {row: number, column: string, value: any}
• headers（可選）
  • 是否在第一行添加標題，默認為 true。

write_sheet_data_all

向 Excel 文件中的所有工作表寫入數據。

參數：

• fileAbsolutePath
  • Excel 文件的絕對路徑

配置環境變量

通過以下環境變量調整 MCP 服務器的行為：

EXCEL_MCP_PAGING_CELLS_LIMIT

每次分頁操作中讀取的最大單元格數。
[默認值：4000]

📄 許可證

版權所有 (c) 2025 Kazuki Negoro

Excel MCP Server 根據 MIT License 發佈