第三方工具更新 2026.11.18

Excel MCP 教學:Windows 接上 Claude Code、Codex,讀寫公式與計算結果

Windows安裝Excel MCP並接上Claude Code與Codex,不需開啟Excel。實際建立報表、核對SUM公式和250結果,附允許目錄及舊版參數排錯。

Excel MCP Server 讓 AI 直接讀寫本機 .xlsx,不必先開啟 Microsoft Excel。這篇使用 Haris Musa 維護的 Python 版本,適合整理報表、補公式與核對金額;如果只是請 AI 解釋一段貼上的資料,直接貼表格就夠了。搜尋結果裡有好幾個同名專案,安裝前先核對套件是 excel-mcp-server。

Windows 安裝與連線

先準備 uv 和 Python 3.12。以下在一個新的工作資料夾用 PowerShell 執行。固定 2.3.1,避免舊版工具名稱與新版混用。

uv venv --python 3.12 .venv
uv pip install --python .\.venv\Scripts\python.exe excel-mcp-server==2.3.1
New-Item -ItemType Directory -Force workbooks | Out-Null
$server = (Resolve-Path .\.venv\Scripts\excel-mcp-server.exe).Path
$books = (Resolve-Path .\workbooks).Path

Claude Code:

claude.cmd mcp add excel --scope project --env PYTHONUTF8=1 --env PYTHONIOENCODING=utf-8 -- $server stdio --allow-dir $books
claude.cmd mcp list

看到 Connected 後,在這個專案重新開啟 Claude Code。Codex 使用相同執行檔:

codex mcp add excel --env PYTHONUTF8=1 --env PYTHONIOENCODING=utf-8 -- $server stdio --allow-dir $books
codex mcp list

Codex 的註冊會保存在使用者設定;--allow-dir 才是伺服器讀寫檔案的範圍。範例只開放 workbooks,相對檔名 sales.xlsx 就會落在這裡。這也避免把整個磁碟的活頁簿交給工具。

Cursor 可依上游的 Cursor 設定,在 .cursor/mcp.json 使用同一個執行檔、stdio 和允許目錄;Windows JSON 裡的反斜線要寫成 \\,或改用 /。

三個可以直接用的任務

1. 建立一份可交接的報表

貼給已接上工具的 AI:

只用 Excel MCP。建立 sales.xlsx,工作表 Sales。
A1:B4 寫入:Region,Amount;Taipei,120;Taipei,80;Kaohsiung,50。
B5 寫入公式 =SUM(B2:B4)。完成後讀回 A1:B5,不要只回覆「已建立」。

2.3.1 會使用 create_workbook、write_range 和 read_range。檔案存好後,數值模式的 B5 應是 250;這一步可以把「AI 說寫好了」和真正的檔案內容分開確認。

2. 分清公式與計算結果

用 read_range 讀 sales.xlsx 的 Sales!A1:B5,先用 mode=values,
再用 mode=formulas。列出 B5 的兩種回應,不要把公式字串當成數值。

我們讀到的值是 250,公式是 =SUM(B2:B4)。這個版本有本機公式計算能力,因此沒用 Excel 開過檔案也能讀到這個 SUM 結果;不能由此推論所有 Excel 函數都能計算。遇到不支援的公式,先看回應的 uncalculated,再決定是否要交給 Excel 計算。

3. 確認工具沒有越過指定資料夾

在自己的測試資料夾執行這個唯讀要求:

用 Excel MCP 嘗試讀 ../outside.xlsx,記錄原始錯誤;不要建立這個檔案,
也不要改設定或移動檔案來繞過限制。

我們收到 Path '../outside.xlsx' is outside the allowed directories.。這是路徑限制生效,不是檔案損毀;正常報表應放回允許目錄內,再使用相對檔名。

常見錯誤

  • error: unknown option '--allow-dir': PowerShell 呼叫 npm 的 claude.ps1 時,未加引號的 -- 可能先被 PowerShell 處理掉,後面的伺服器選項就落到 Claude。改用上面的 claude.cmd 保留分隔符;我們用相同伺服器與參數重新註冊後得到 Connected。
  • 找不到 uvx 或伺服器執行檔: AI 客戶端的 PATH 可能和終端機不同。使用上面 Resolve-Path 得到的完整 .exe 路徑,並確認虛擬環境沒有被搬走。
  • 出現 outside the allowed directories: 相對路徑以允許目錄為基準。已經指定 workbooks 時,傳 sales.xlsx,而不是再加一層 workbooks/sales.xlsx;不要用 .. 取其他位置的檔案。
  • 舊提示詞找不到工具或參數: 2.x 的工具與欄位經過改名。本例是 write_range 的 at、rows,以及 read_range 的 mode;先讓 AI 取得目前工具結構,別沿用 1.x 範例。
  • 公式有字串卻沒有結果: 用 formulas 確認公式確實存在,再檢查 values 的未計算說明。讀取公式字串和驗證計算正確是兩件事。

費用、限制與替代選擇

伺服器採 MIT 授權,本機操作不需要 Microsoft 365、服務帳戶或 API key;AI 客戶端本身的用量另外計算。它處理現代 Excel 檔案,不支援舊 .xls,也不是畫面上的 Excel 自動化。複雜公式、巨集與樞紐分析表應另做檔案驗證;本篇的 SUM 例子沒有涵蓋這些功能。

如果資料原本在 CSV,目的是反覆查詢加總而不是交付活頁簿,DuckDB MCP 比維護儲存格位置合適。只需要替 AI 讀一般文字檔,可看 Filesystem MCP。

FAQ

Excel MCP 需要安裝 Excel 嗎?

這篇選的 Haris Musa 版本不需要,它直接操作活頁簿檔案。同名的其他專案可能使用 Windows COM 或正在開啟的 Excel,因此不能把它們的需求混在一起。先看套件和上游,再套用設定。

Claude Code 和 Codex 可以共用同一份報表嗎?

可以把兩個客戶端指向相同允許目錄,但應輪流修改同一檔案。每次修改後讀回內容,避免兩個 AI 同時存檔覆蓋彼此的變更。mcp list 用來確認設定或連線,報表是否正確仍要靠實際讀回。

沒開 Excel,SUM 為什麼會有答案?

2.3.1 會在沒有可用快取值時,對支援的公式做本機計算。我們以同一個 B5 同時讀到公式字串與數值 250,並從存檔確認公式仍在。這是這個範例的結果,不是完整 Excel 計算引擎相容性的結論。

我們測了什麼

2026-11-16:Windows、Python 3.12、excel-mcp-server 2.3.1、Codex CLI 0.169.0。Codex 真正建立與讀回活頁簿,驗證 SUM=250、公式保存及越界拒絕;Claude Code 完成註冊與 Connected 檢查。Cursor、大型活頁簿及進階公式未實機測試;設定與功能範圍參考官方 README與工具說明,查閱日期同上。

訂閱 AI 工具精選與使用建議

有值得推薦的新工具、實測發現或重要更新時,寄到你的信箱。

訂閱後先寄給你一份每月更新的 AI 工具與 Skill 清單。有值得推薦的工具、實測發現或重要更新時才寄信,隨時可以退訂。隱私權說明

快完成了,請到信箱收確認信點信裡的按鈕確認訂閱,就會收到工具清單的下載連結。沒看到的話,看一下垃圾郵件或「促銷內容」分頁。

看過去幾期

也可以在這些平台追蹤: