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：

• 即時編輯 MS 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"
            }
        }
    }
}

通過 Smithery 安裝

要自動為 Claude Desktop 安裝 Excel MCP Server，請通過 Smithery：

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

📚 詳細文檔

要求

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

支持的文件格式

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

工具

read_sheet_names

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

參數：

• fileAbsolutePath：Excel 文件的絕對路徑

read_sheet_data

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

參數：

• fileAbsolutePath：Excel 文件的絕對路徑
• sheetName：Excel 文件中的工作表名稱
• range：要讀取的 Excel 工作表範圍（例如："A1:B2"）。默認情況下，如果未指定範圍，則從第一個單元格開始按分頁讀取。

read_sheet_data_with_range

按分頁讀取 Excel 工作表中指定範圍的數據。

參數：

• fileAbsolutePath：Excel 文件的絕對路徑
• sheetName：Excel 文件中的工作表名稱
• startRow：要讀取的起始行號
• endRow：要讀取的結束行號
• 每次最多讀取 4000 個單元格。

read_sheet_formula

按分頁讀取 Excel 工作表中的公式。

參數：

• fileAbsolutePath：Excel 文件的絕對路徑
• sheetName：Excel 文件中的工作表名稱

write_sheet_data

將數據寫入 Excel 工作表。

參數：

• fileAbsolutePath：Excel 文件的絕對路徑
• sheetName：Excel 文件中的工作表名稱
• data：要寫入的數據（例如：{A1: "value"}）

write_sheet_formula

將公式寫入 Excel 工作表。

參數：

• fileAbsolutePath：Excel 文件的絕對路徑
• sheetName：Excel 文件中的工作表名稱
• formula：要寫入的公式（例如：{A1: "=A2+B2"}）

配置

你可以通過以下環境變量更改 MCP 服務器的行為：

EXCEL_MCP_PAGING_CELLS_LIMIT

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

📄 許可證

版權所有 (c) 2025 Kazuki Negoro

excel-mcp-server 按照 MIT License 發佈