跳至內容
AI Agent
QGIS
指南

QGIS MCP 是什麼?安裝步驟、限制與更簡單的做法

發布於 更新於

QGIS MCP 是一個免費的 QGIS 外掛,加上電腦上的一個小程式,讓 QGIS 以外的 AI 應用程式(通常是 Claude Desktop 或 Claude Code)可以控制 QGIS。您在 AI 應用程式中輸入需求,它透過本機連線把指令送到 QGIS,由 QGIS 執行:載入圖層、執行空間運算工具、設定地圖樣式,或執行 Python 程式碼。

兩列架構比較。上列是 QGIS MCP,需要自行安裝、設定並啟動四個部分:AI 用戶端(例如 Claude Desktop、Claude Code 或 Cursor,各有自己的方案),透過 stdio 連到 MCP 伺服器(用 uv 以 uvx qgis-mcp-server 啟動的 Python 程序),再透過 TCP 連接埠 9876 連到 QGIS MCP 外掛(QGIS 內的 socket 伺服器,每次工作階段都要按下 Run MCP),最後操作您的 QGIS 專案。下方一列是 AI Agent,只有一個外掛:停駐在 QGIS 內的 AI Agent 面板,從外掛管理員安裝,能看到圖層、欄位、CRS、範圍與選取範圍,透過 HTTPS 連到在歐盟執行模型的 Agent 服務,不需要 API 金鑰或用戶端應用程式,同樣操作您的 QGIS 專案。
上:QGIS MCP 需要同時運作的四個部分。下:直接在 QGIS 內運作的 Agent 外掛,這裡是我們的外掛。

這個構想很好,外掛也做得扎實。QGIS 官方外掛庫中的版本由 Nicolas Karasiak 維護,截至 2026 年 9 月 26 日已有 52,575 次下載。教學文章很少提到的是:要讓它跑起來得花多少功夫,以及它在哪裡會碰到瓶頸。我從零開始安裝了一遍,再把同一個任務交給它和一個在 QGIS 內運作的 Agent。後者是我們做的 AI Agent,所以請帶著這一點來看我的結論。

一段話說明 MCP

MCP(Model Context Protocol)是由 Anthropic 發起的開放標準,讓 AI 應用程式可以使用外部工具。官方簡介形容它是「AI 應用程式的 USB-C 連接埠」。AI 應用程式稱為用戶端,伺服器則向它提供工具。QGIS MCP 就是一個伺服器,它提供的工具就是 QGIS 的各種操作。協定本身也直接點出風險:「工具代表任意程式碼的執行,必須謹慎對待。」

QGIS MCP 如何運作

下列四個部分必須同時安裝並運作:

  1. MCP 用戶端:您輸入需求的 AI 應用程式,例如 Claude Desktop、Claude Code、Cursor、VS Code、Codex CLI 或 Gemini CLI。
  2. MCP 伺服器:用戶端透過 uv 在背景啟動的一個小型 Python 程式,uv 是用來安裝並執行 Python 程式的工具,需要先安裝。
  3. QGIS MCP 外掛:在 QGIS 內,透過本機網路連接埠 9876 接收指令。您要按下它工具列按鈕上的 Run MCP 才會啟動。
  4. QGIS 本身,並開啟您的專案。

當您輸入需求時,AI 模型會挑選一個 QGIS 工具,伺服器把呼叫轉給外掛,外掛在 QGIS 中執行後把結果傳回來。模型看不到您的螢幕,只有在它要求 QGIS 提供地圖畫面時才看得到地圖。

開始之前需要準備什麼

項目用途費用
QGIS 3.28 或更新版本外掛的最低需求免費
MCP 用戶端應用程式與模型對話的地方有每日上限的免費方案,或付費方案
uv(Python 套件執行工具)啟動 MCP 伺服器免費,用一行終端機指令安裝
一行終端機指令或設定檔中的一筆設定告訴用戶端伺服器在哪裡免費,但要手動設定
QGIS MCP 外掛橋接的 QGIS 這一端免費

一篇廣為流傳的安裝教學說您需要付費的 Claude Pro 帳戶,其實不用。Anthropic 關於本機 MCP 伺服器的說明文件沒有指定任何方案,也有 GIS 部落客在 2026 年 8 月用 Claude 的免費方案執行 QGIS MCP,只是會碰到每日訊息數上限。ChatGPT 就比較麻煩:OpenAI 的說明中心表示,它只能連到網際網路上的 MCP 伺服器,無法連到您電腦上的伺服器,而且所需的開發人員模式只開放給付費方案。

實際計時:安裝 QGIS MCP

我在 2026 年 9 月 26 日於 QGIS 3.44 上安裝 QGIS MCP 0.15.0,並記錄了每個步驟。外掛自己的頁面就說得很坦白:「此外掛只是整套設定的一半。您還需要 qgis-mcp MCP 伺服器,由您的 MCP 用戶端執行,才能與 QGIS 溝通。」

  1. 安裝外掛

    「外掛程式」→「管理並安裝外掛程式」,搜尋 QGIS MCP,按下「安裝外掛程式」。這一步很快:載入只花了 2.7 秒,不用重新啟動。

  2. 安裝 uv

    伺服器透過 uv 執行,而 Windows 和 macOS 都沒有內建。您要在終端機中用一行指令安裝。

  3. 準備 MCP 用戶端

    Claude Code、Claude Desktop、Cursor、Codex、Gemini CLI,或其他支援 MCP 的應用程式,並有自己的帳戶與方案。

  4. 讓用戶端連到 QGIS

    外掛的 Configurator 會顯示一行要貼到終端機的指令,例如 claude mcp add -s user qgis -- uvx ... qgis-mcp-server。有些用戶端則需要在設定檔中加一行。

  5. 在 QGIS 中啟動伺服器

    按下外掛工具列按鈕上的 Run MCP。QGIS 啟動時會記錄「Token authentication disabled (open)」。

  6. 送出第一則訊息

    第一次呼叫會下載伺服器(約 90 MB)再連線。我的測試花了 16 秒,用戶端看到 125 個 QGIS 工具。

下方截圖中的 Configurator 就是您選擇用戶端並複製終端機指令的地方。

左:QGIS 外掛管理員中 QGIS MCP 0.15.0 的頁面,作者 Nicolas Karasiak,387 票、52,575 次下載,說明寫著此外掛只是整套設定的一半,還需要 qgis-mcp MCP 伺服器。右:外掛的 Setup and Configurator 視窗,用戶端選為 claude-code,狀態為 Server running on port 9876,並附上以 claude mcp add 開頭、要在終端機執行的指令。
外掛頁面與它的 Configurator。QGIS 這一端很快,其餘的步驟都發生在終端機和另一個應用程式裡。

我的這次流程約花了三分鐘,但 uv 和用戶端早已裝好,而且有腳本代為點擊。第一次做的人還得閱讀說明文件、安裝 uv 和用戶端,再自己輸入指令。

有一部分每天都會再來一次。QGIS 重新啟動後,除非您在 Configurator 中勾選自動啟動,否則伺服器會維持關閉。AI 應用程式只會顯示「Error executing tool ping」,您得自己猜出解法是再按一次 Run MCP。

同一個任務,兩種做法

我把相同的需求交給兩個工具,同一時間在同一台電腦上,各在全新的 QGIS 專案中執行:「在法國里昂,找出離電車站 300 公尺內的學校,連同電車路線一起顯示在地圖上,並告訴我共有多少所。」

QGIS MCP 搭配 Claude CodeAI Agent
得到答案的時間9 分 28 秒5 分 35 秒
步驟數10 個,其中 6 個是 Python 程式碼40 個,其中 2 個是 Python 程式碼
採用的資料OpenStreetMap,由它自己寫的 Python 下載Métropole de Lyon 官方的小學、國中與高中圖層,加上 OpenStreetMap 的電車站與軌道
計得的學校數8780(52 所小學、14 所國中、14 所高中)

兩個數字不同,是因為兩個工具用的資料不同。QGIS MCP 計算的是 OpenStreetMap 上靠近電車站的學校,而電車站取自里昂周圍的一個方框範圍,所以城外剛好在邊緣的幾個站也算進去,它自己也說明 87 這個數字沒有去除重複。AI Agent 用的是市府官方的學校名冊與里昂市的行政區界線。

過程的差別更大。QGIS MCP 沒有資料工具,所以模型寫 Python 去查詢 OpenStreetMap 的 Overpass 伺服器。伺服器回傳了錯誤(406、504,然後兩次 502),它就重試。那段 Python 跑在 QGIS 的主執行緒上,所以 QGIS 凍結了約 7 分鐘,地圖一直是空的,直到 7 分 22 秒。

QGIS MCP 在里昂執行後的 QGIS 畫面:離電車站 300 公尺內的學校是紅點,電車路線是藍線,電車站是灰點,背景是白色,沒有底圖。圖層面板列出 schools_within_300m、tram_lines、tram_stops,以及一個隱藏的 schools_all 圖層。
QGIS MCP 搭配 Claude Code:9 分 28 秒、87 所學校,每次下載都靠 Python 寫成。

AI Agent 先搜尋自己的資料目錄,載入市府官方的學校圖層。全國公共運輸資料沒有標示里昂的電車時,它改用 OpenStreetMap 取得電車站與軌道。它寫了兩次 Python,用來計算每所學校到最近電車站的距離。

QGIS 右側是 AI Agent 面板。地圖上顯示里昂市界線、電車軌道,以及離電車站 300 公尺內的學校,依名稱標註,並依小學、國中與高中上色。Agent 的回覆有一張統計卡片,顯示 80 所學校(52 所小學、14 所國中、14 所高中),到最近電車站的距離為 14.6 至 297.2 公尺,接著列出資料來源:Métropole de Lyon 的學校、OpenStreetMap 的電車站與軌道、里昂市界線,以及一份 GTFS 擷取檔。
AI Agent:5 分 35 秒、80 所學校,來自市府自己的學校圖層。

另外三個任務,其中一個 QGIS MCP 比較快

只跑一次說明不了什麼,所以我用同樣的方式又計時了三個任務。結果不會都對我們有利:

任務QGIS MCP 搭配 Claude CodeAI Agent
波圖歷史中心的建物依類型上色,疊在衛星底圖上1 分 44 秒1 分 21 秒
同上,再加上 A4 PDF 版面,含標題、圖例、比例尺與指北針2 分 48 秒5 分 26 秒
約克有河川洪水風險的建物,使用 Environment Agency 的資料15 分鐘後仍未完成,地圖上什麼都沒有15 分鐘後仍未完成,載入了部分洪水資料,沒有計數

當資料只要一次 OpenStreetMap 下載就能取得時,QGIS MCP 跟得上,在 PDF 版面上還快了大約一倍。它自己的回覆就提醒,匯出 PDF 時並沒有確認衛星圖磚是否已載入。差距出現在模型得自己找資料、下載資料的時候,就像里昂那一項。約克的洪水任務,兩個工具在 15 分鐘內都沒有完成。9 月 26 日第一次跑波圖時,QGIS MCP 花了 8 分 29 秒,因為那天下載伺服器負載過重,所以我把所有任務重新計時了一遍。

測量方式。 同一台電腦、兩個工具同時執行,QGIS 3.44.15、全新專案與預設設定,唯一例外是 AI Agent 的強度設為 Medium。各跑一次,不重試:QGIS MCP 0.15.2 由 Claude Code 搭配 Claude Sonnet 5.5 操作,只開放 QGIS 工具;AI Agent 為 1.9.0,使用 Balanced 模式。QGIS MCP 的時間是 Claude Code 自己的執行時間,不含用戶端啟動花的 52 秒。里昂的比賽期間電腦負載很重,OpenStreetMap 伺服器對兩個工具都在回報錯誤。每次執行我們都錄了影。

您可以在自己的 QGIS 裡用幾分鐘送出同一個需求:安裝外掛、登入,再把需求貼進面板。

QGIS MCP 的不足之處

以下是我親身碰到或在文件中查到的限制,每一項都有出處:

  • 對話在 QGIS 之外。 您得在兩個視窗之間切換。模型靠工具的回傳結果作業,只有在它要求 QGIS 提供地圖畫面時才看得到地圖。
  • 四個會動的零件。 什麼都沒發生時,問題可能出在用戶端設定、uv、伺服器、連接埠或外掛。專案的疑難排解頁面把「No response from QGIS」、Connection refused 和 ModuleNotFoundError 列為常見錯誤。
  • Windows 的陷阱。 README 警告,從 Microsoft Store 安裝的 Claude Desktop 會在沙箱中執行伺服器,導致一般的設定方式失效,所以在別處可行的設定檔在那裡會失敗。
  • 可執行任何 Python,預設沒有密碼。 execute_code 工具會執行模型寫出的任何 PyQGIS(QGIS 的 Python 程式碼)。README 自己也這麼說:「預設情況下 socket 沒有驗證……任何能連到該連接埠的本機程序都可以操作 QGIS(包括能執行任意 PyQGIS 的 execute_code)。」有一個分支專案 QGIS Agent MCP 的存在,主要就是為了移除這個工具。
  • 沒有自己的資料。 它負責操作 QGIS,但找資料、下載資料要靠模型,通常是寫 Python。在里昂的測試中,10 個步驟裡有 6 個是 Python,下載讓 QGIS 凍結了約 7 分鐘。
  • 無法整次需求一鍵復原。 QGIS 的復原只涵蓋編輯,不包含新增的圖層或寫出的檔案。
  • 星數最多的版本不是持續維護的版本。 GitHub 上的原始專案 jjsantos01/qgis_mcp 有 1,099 顆星,但自 2025 年 10 月 1 日起就沒有程式碼變更,還有一個標題為「Broken plugin for QGIS version 4.01」的未解決議題。持續維護的版本是 nkarasiak/qgis-mcp,也就是 QGIS 外掛庫中的那一個。

網路上說錯的地方

「您需要 Claude Pro。」 本機 MCP 伺服器在 Claude 的免費方案上也能運作,只是受每日上限限制。需要付費方案的是 ChatGPT,而它本來就無法直接連到您電腦上的伺服器。

「編輯設定檔後要重新啟動電腦。」 重新啟動用戶端應用程式就夠了。在 Windows 上,請確認它已完全結束,因為它會繼續留在系統匣中執行。

「安裝星數最多的那個儲存庫。」 請改從 QGIS 外掛管理員安裝,那樣拿到的是持續維護的版本。

把 Claude 連到 QGIS 的其他方式

上面那款外掛是多數教學所指的那一個,但另外還有三個專案也能把 Claude 放進 QGIS。以下是我在 2026 年 10 月 23 日從它們各自的頁面讀到的內容:

  • piatkowski/qgis-mcp: 另一個同名的獨立專案,為 Claude Desktop 而做。它從 GitHub releases 頁面下載 ZIP 安裝,不經外掛管理員,伺服器需要 Python 3.12 以上,外掛一啟用就開始監聽 9876 連接埠。上面那款外掛也用 9876 連接埠,所以一次只跑一個。
  • ClaudIA QGIS: 衍生自上面那款外掛,把本機連接埠換成透過 HTTPS 連到 agrônomo10X 社群,所以不用安裝 Python。需要 agrônomo10X 帳號,2026 年 9 月 15 日的 0.2.3 版標示為實驗性。
  • QGIS Agent: QGIS 裡的對話面板,使用您自己的 LLM 金鑰,另有一個選用的本機 MCP 伺服器,可由 Claude Desktop 或 Cursor 操控。

QGIS MCP 的替代方案:QGIS 內建的 Agent

AI Agent 是我們做的,所以這一節談的是我們自己的外掛。它和 QGIS MCP 做的是同一件事,但是在 QGIS 內部完成:對話是停駐在地圖旁邊的面板,模型隨外掛一併提供。在 Google 的 GeoKTools 與 GeoExpertQueries 基準測試中,Claude Sonnet 5.5 透過這個 MCP 外掛(0.15.1 版,在 Claude Code 中)操作 QGIS,在 41 道保留題上得 24.9 分(滿分 100),而 Low 強度(GPT-6 Luna)的 AI Agent 得 43.8 分(基準測試結果)。

日常使用上差別最大的是:

  • 只裝一次。 「外掛程式」→「管理並安裝外掛程式」,搜尋 AI Agent by TerraLab,安裝後登入。不需要 uv、設定檔、另一個應用程式,也不必每次工作階段都啟動伺服器。
  • 看得到您的專案。 圖層名稱、欄位、CRS、範圍與選取範圍會隨每個需求一起送出,它還會繪製地圖來檢查自己的成果。
  • 內建資料。 內含 190 個開放資料來源的目錄,從 OpenStreetMap 到 Sentinel-2,再到各國測繪機關,所以模型不必寫下載程式碼。
  • 先詢問再動手。 預設設定下,刪除或覆寫之前它會先停下來,而會更動您專案的 Python 一律需要您按下確認。
  • 每則訊息都能復原。 每則訊息都會留下一個還原點,按一下就能讓專案回到那個狀態。

它需要網際網路連線,並且只會把專案的描述(絕不是您的資料檔案)傳送到託管在歐盟的服務。有不需信用卡的 Free 方案,而且一則訊息就算一次任務,不論需要多少步驟。免費試用 Pro 7 天:綁定信用卡,到期前取消就不收費。

在 QGIS 免費試用 AI Agent,不需信用卡

QGIS MCP 與 QGIS 內建 Agent 並排比較

QGIS MCPAI Agent
對話的地方外部應用程式(Claude Desktop、Cursor、Claude Code)QGIS 內的面板
要安裝的東西外掛、uv、MCP 用戶端、一筆設定一個外掛
每次工作階段在 QGIS 中啟動伺服器,兩個應用程式都要開著開啟面板
模型您的用戶端用什麼就是什麼,費用算在您的方案上已包含
開放資料目錄無190 個來源
執行 Python可以,預設不先詢問更動專案的程式碼會先詢問
整次需求一鍵復原否是,按一下即可
價格外掛免費,另加您的 AI 方案費用Free 方案,之後 Pro 為每月 €49
最適合已經在 Claude Code 或 Cursor 中工作的開發者想直接在 QGIS 裡得到結果的 GIS 使用者

該選哪一個?

如果您已經在用 Claude Code 或 Cursor、會寫 Python,又想把 QGIS 當成其中的一項工具,QGIS MCP 很適合,而且除了您原本就在付的 AI 方案之外,不用多花一毛錢。如果您只想輸入一項 GIS 任務、直接在專案裡看到結果,不想碰終端機、uv 或第二個應用程式,QGIS 內建的 Agent 需要設定和維護的東西比較少。我認識的 GIS 使用者大多屬於後者。

重點整理

QGIS MCP 透過本機連線,把 QGIS 以外的 AI 應用程式(例如 Claude Desktop)接到 QGIS,讓該應用程式的模型可以執行 QGIS 工具與 Python。

它需要四個部分同時運作:用戶端應用程式、uv 與 MCP 伺服器、已啟動伺服器的 QGIS MCP 外掛,以及 QGIS。

QGIS 這一端幾秒就裝好。其餘都在 QGIS 之外:安裝 uv、安裝 AI 應用程式、輸入終端機指令,以及每次重新啟動後再按一次 Run MCP。

在里昂的任務上,AI Agent 用市府官方的學校圖層,5 分 35 秒就給出答案。QGIS MCP 花了 9 分 28 秒,10 個步驟中有 6 個是寫 Python。在比較簡單的任務上差距縮小,做 PDF 版面時 QGIS MCP 還比較快。

ChatGPT 無法直接使用本機 MCP 伺服器。Claude 的免費方案可以,只是受每日上限限制。

像 AI Agent 這樣在 QGIS 內運作的 Agent,用一個外掛就能完成同樣的工作,模型、資料目錄與一鍵復原都已包含在內。

常見問題

QGIS 中的 AI Agent 是什麼一文統計了官方外掛庫中全部 38 款 Agent 與助理外掛,MCP 橋接外掛也包含在內。AI Agent 指南展示十個真實執行案例與它們的 prompt,PyQGIS 則測量了聊天機器人寫出的程式碼第一次就能執行的比例。QGIS AI 專區比較了更廣泛的選擇。

在 QGIS 裡開口就能完成

AI Agent 會在你自己的 QGIS 專案中,執行你描述的任務。免費使用,不需信用卡。

免費試用 AI Agent
由以下作者撰寫Yvann Barbot
·7 min read

繼續閱讀

QGIS 中的 AI Agent:以面量圖呈現浦那各選區的學校數,附上指令與 58 個選區共 256 所學校的統計。
AI AgentQGIS指南

Claude 怎麼連接 QGIS?三種方法用同一項任務實測

QGIS 沒有官方的 Claude 外掛。本文介紹在 QGIS 中使用 Claude 的三種方法:MCP、貼上 PyQGIS 程式碼、QGIS 內的代理外掛,用同一項製圖任務實測,並告訴您該選哪一種。

Yvann BarbotYvann Barbot
·
並排的兩張已匯出 A4 列印圖面配置。左邊是聊天機器人的第一次回答:標題、圖例和指北針圍著一個空白的地圖框,並標註「執行時沒有報錯,但地圖框是空的」。右邊是 AI Agent 製作的安錫學校圖面配置,包含行政區、依類型著色的學校、圖例和比例尺,並標註「一則訊息」。
AI AgentQGIS指南

ChatGPT 能寫 QGIS 程式碼嗎?三項實測結果

ChatGPT 能為 QGIS 撰寫 PyQGIS 程式碼,但看不到您的專案。我們讓它處理三項真實任務並逐一在 QGIS 執行,結果有一個腳本沒有報錯卻輸出空白地圖。

Yvann BarbotYvann Barbot
·