安裝
npx -y @figwright/mcp@latest適合誰
如果你希望 AI 代理不只是「看看」Figma，而是透過本地 WebSocket 中繼連上官方外掛，既讀設計又寫畫布，這個免費雙向 MCP 對得上。它面向 Claude Code、Cursor、Codex 以及任何 MCP 用戶端。一共 113 個工具，覆蓋讀、寫和 grounding，所以代理既能按設計實作，也能在畫布上搭建。它跑在 Figma 免費檔，不像官方 Dev Mode MCP 那樣要付費席位。它適合本機設計協作，不適合在沒有桌面端、或外掛未連上時呼叫寫工具，也不適合把 113 個未點名工具當成已知 API。摘要稱資料留在本機；讀檔和寫畫布仍是本地隱私邊界，不是「沒有本機讀取」。
3 分鐘完成第一次嘗試
先確認 MCP 用戶端、Figma 桌面端，以及 Node.js 20.19+ 或 22.12+。官方寫明不支援 Node 18/21 和 22.0–22.11；伺服器由 npx 單獨拉起，版本可與專案建置用的 Node 不同。免費檔即可，但匯入外掛需要桌面應用。用戶端主設定為：
npx -y @figwright/mcp@latest
不需要全域安裝。啟動後按倉庫說明在 Figma 桌面匯入外掛，並確認本地 WebSocket 中繼已連通。先做低風險讀取：在用戶端列出的工具裡選唯讀或 grounding，查看目前選區或頁面結構。證據沒有點名這 113 個工具；缺了就按清單呼叫，不要發明圖層 API。成功訊號是回傳設計結構，而不是畫布被改寫。寫畫布前必須先看到讀取成功。可選的 npx skills add awdr74100/figwright/skills 不是主路徑，且技能要求 MCP 已連接。倉庫： https://github.com/awdr74100/figwright
使用案例
案例一：按設計實作。外掛連通後，用讀取/grounding 類工具理解框架感知的設計結構，再在本機產出程式。標題寫明可把設計變成框架感知程式。證據沒有寫支援哪些框架名稱；缺了就以用戶端回傳的結構為準，不要補造匯出格式。
案例二：把結果寫回畫布。要用代理在 Figma 裡搭建或回推程式時，使用寫畫布工具。這會改設計檔，屬於有副作用的動作：先確認目前檔是可丟棄副本或你明確要改的檔，再執行。證據只保證雙向、非唯讀；沒有撤銷步驟。失敗時以 Figma 歷史為準，不要發明 undo 命令。
使用邊界
沒有桌面端就匯不進外掛，中繼也就連不上。Node 版本不符時不要硬跑。113 個工具名未公布，禁止自行編造。寫操作會改畫布；唯讀成功前不要批量寫入。官方 Dev Mode MCP 的付費限制不適用於 Figwright，但 Figwright 也不是 Figma 官方席位替代品。技能包是附加物，不能代替 @figwright/mcp。不要假設代理看不到你的設計檔。第一次嘗試只走 npx -y @figwright/mcp@latest，成功訊號定為一次唯讀結構回傳。