哈囉，Lena 來了。那天下午我其實沒打算搞什麼很複雜的東西。

我只希望 Cursor 能伸進資料庫把脈絡拉出來，不用我手動複製。理論上很單純。但第一次看 Cursor 裡的 MCP Server 時，我停得比預期久。設定面板和兩個版本前我記得的文件略有不同。設定路徑換過了。介面多了一個標籤。不是壞掉——只是……和我記得不一樣。

這篇文章其實在講這個。不只是「給你 JSON」。比較像——我仔細走一遍時注意到什麼，包含一開始讓我卡住的地方。

MCP Server 在 Cursor 裡做什麼

Cursor IDE 內部的工具呼叫怎麼運作

MCP——Model Context Protocol——是開放協定，標準化應用程式如何把工具與脈絡交給 LLM。Anthropic 在 2024 年 11 月開源。到 2025 年中，OpenAI 與 Google DeepMind 也採用了。2025 年 12 月，它併入 Agentic AI Foundation——Linux Foundation 底下的專案。那個轉變有點意義。它從比較像 Anthropic 自家的東西，變得更像真正共用的基礎。

在 Cursor 裡，MCP 對 Agent 來說像一層外掛。你開 Agent session 時，Cursor 會掃描已啟用的 MCP Server、載入它們暴露的工具，並判斷在執行任務時要呼叫哪些。

協定定義三塊：host（Cursor 本身）、client（Cursor 內部的連接器）、server（另一端的輕量程式，透過 JSON-RPC 2.0 暴露工具）。

主力是 tools——可執行函式，例如 create_issue 或 run_query。Cursor 很早就支援 tools。Resources——像檔案內容、資料庫 schema 這類脈絡資料——在 Cursor v1.6（2025 年 9 月）才到齊。Prompts（讓 server 提供可重複使用的模板）則稍晚一點。

嗯……我沒意識到 resources 這麼新。這或許能解釋為什麼有些舊教學讀起來不完整。

開始之前：前置條件

支援 MCP 的 Cursor 版本

MCP 支援已經在 Cursor 裡存在一陣子了，但設定格式在版本之間換過。做任何事之前，先確認版本。開啟 Cursor → Help → About。截至 2026 年初的穩定版支援三種傳輸：stdio、SSE、Streamable HTTP。

值得確認的一件事：設定面板現在把這區標成 Tools & MCP，不再只是「Extensions」或更泛用的名稱。若你在找卻找不到——多半就是這個原因。

依 server 而定的 Node.js 或 Python 需求

多數你會遇到的 MCP Server 跑在兩種技術棧之一：

以 Node.js 為基礎的 server——透過 npx 或 node 啟動。需要 PATH 裡有 Node.js 18+。
以 Python 為基礎的 server——透過 uv run 或 python 啟動。需要 Python 3.10+，且常用 uv 當套件管理器。

我會建議先在終端機跑 node --version 和 python --version。聽起來很基本，但漏掉這步默默害失敗的設定比想像多。Server 程序就是……永遠起不來，而面板裡 Cursor 也幾乎不給有用訊息。

如何把 MCP Server 加進 Cursor

步驟一：找到或建好自己的 MCP Server

已經有不少現成 server——GitHub、Postgres、Slack、瀏覽器自動化等等。GitHub 上的官方 MCP Server 登錄是合理的起點。有些文件裡有一鍵「Add to Cursor」，會自動處理設定。

若你要自己做：server 只要會往 stdout 印（stdio transport）或提供 HTTP 端點即可。任何語言都行——這也是它和我以前用過的外掛系統感覺略有不同的原因之一。

步驟二：在 Cursor 設定裡配置

這裡我想講精準一點，因為格式很重要，而文件不一定會在你寫錯時提醒你。

有兩個設定位置：

專案範圍：專案根目錄的 .cursor/mcp.json
全域：家目錄的 ~/.cursor/mcp.json

結構長這樣：

JSON

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "your-mcp-server-package"],
      "env": {
        "API_KEY": "your-value-here"
      }
    }
  }
}

env 欄位用來傳 API 金鑰與敏感設定——不要塞進 args。我花了一點時間才直覺搞懂這點。

很常絆到人的一點：若漏掉根層的 "mcpServers"，Cursor 會靜默忽略整份檔案。沒有錯誤、沒有警告。Server 就是不出現。我不確定為什麼是這樣，但確實如此。

若用 uv 跑 Python server：

JSON

{
  "mcpServers": {
    "my-python-server": {
      "command": "uv",
      "args": ["run", "--with", "my-server-package", "my-server-package", "run"]
    }
  }
}

也可以透過介面加：Settings → Tools & MCP → New MCP Server。若你不太想直接編 JSON，這條路通常比較寬容。

步驟三：驗證連線

存檔後開啟 Settings → Tools & MCP。每個 server 應該會帶狀態指示——綠色表示已連上，其他狀態代表尚未連上。

若 server 沒出現：先檢查根鍵（"mcpServers"，不是 "servers" 或其他）。再確認指令在 PATH 裡真的找得到。Cursor 在這裡不一定會顯示有用錯誤——這仍是我覺得有點懸而未決的部分。

步驟四：在 Agent session 裡測試工具呼叫

在 Cursor 開新的 Agent session（不是一般聊天）。輸入自然會動用到某個 server 工具的內容。Cursor 在執行前應會請你確認——那是預期行為，不是問題。

若工具呼叫有跑但回傳沒用，確認 server 真的匯出你想的那個工具。Tools & MCP 面板會列出每個 server 暴露哪些工具。在假設壞掉之前，那份清單值得先看一眼。

常見 MCP 設定問題排除

Server 不出現

通常是三選一：缺了根鍵 "mcpServers"、指令在 PATH 找不到，或 JSON 語法錯誤。Cursor 對這些都很安靜。手動驗證 JSON——貼到 linter——能省時間。

工具呼叫靜默失敗

Cursor 對所有 server 加總大約有 40 個啟用工具的上限。 超過之後，Agent 會因為脈絡塞滿而較難選對工具。若你開了很多 server，試著關掉暫時不用的，並在 Tools & MCP 面板按重新整理。這招幫過我不只一次。

驗證錯誤

若 server 需要 API 金鑰而工具呼叫因權限失敗，再確認金鑰在設定的 env 欄位，而不是硬編在 args 裡。有些套件也預期特定的環境變數名稱——值得查該 server 自己的文件確認變數名稱。

讓 Cursor 的 MCP 設定可重複使用

為什麼設定會重置、怎麼讓它固定下來

若你只在一個專案裡用 .cursor/mcp.json，換資料夾工作時設定就不見了。我第一次遇到時有點意外。作法是對「到哪都要用」的 server——例如檔案系統 server 或文件查詢工具——另外在全域維護一份 ~/.cursor/mcp.json。

團隊情境下，把 .cursor/mcp.json 提交進版控代表專案裡每個人拿到同一套 server 設定。env 裡的值當然不該提交——那些應放在本機環境設定或祕密管理。

還有一點值得記著：MCP Server 會用你的憑證執行程式碼。你給 server 的任何權限——資料庫存取、GitHub token、API 金鑰——它都會用。在加入任何第三方 server 之前，值得讀官方文件裡的 MCP 安全指引。2025 年與 Cursor MCP 相關的 CVE 已修補，但底層原則不變：把每個 server 都當成完全信任的整合來看待。