這是MCP客戶端入門使用教程系列第二篇:《MCP客戶端入門使用教程之Cursor安裝配置》。
MCP(Model Context Protocol)是由Anthropic(Claude母公司)於2024年11月推出的開放標準協議,它為開發者提供了一個強大的工具,能夠在數據源和AI驅動工具之間建立安全的雙向連接。
簡單來說,如果將AI比作一臺只能處理文字的智能設備,那麼MCP就像給它裝上了"萬能插頭",讓它能直接讀取你的電腦文件、查詢數據庫,甚至操作GitHub提交代碼,以及調用各種第三方平臺等功能。
目前,MCP已被Claude桌面端、Cline、Continue、Cursor、Windsurf等多款AI工具廣泛應用。本文AIbase將重點介紹Cursor編輯器的安裝與MCP服務的配置過程。通過本教程,您將瞭解如何快速設置Cursor並將其連接到MCP服務器,以充分利用AI輔助編程的強大功能。
一、Cursor簡介
Cursor作為MCP客戶端的優勢
Cursor是一款基於VS Code的AI增強代碼編輯器,同時也是一個功能強大的MCP客戶端。作為MCP客戶端,Cursor具有以下優勢:
- 直觀的用戶界面:提供圖形化的MCP服務器配置界面
- 工具調用支持:支持MCP協議中的工具(Tools)功能
- 靈活的配置選項:支持命令行(stdio)和網絡(sse)兩種傳輸方式
- 豐富的生態系統:擁有大量開源MCP服務器資源
二、Cursor安裝步驟
1. 下載Cursor
首先,我們需要從Cursor官網下載最新版本的軟件。訪問Cursor官方網站:https://www.cursor.com/
2.根據您的操作系統會自動提供對應的版本進行下載,大致參考如下:
Windows用戶:選擇Windows10/11(x64)
Mac用戶:根據處理器選擇對應版本(Universal/Arm64/x64)
Linux用戶:選擇.AppImage對應版本
2. 安裝Cursor
Windows安裝步驟:雙擊下載的安裝文件(通常是.exe格式),等待安裝程序自動完成安裝過程(Cursor通常不需要選擇安裝目錄)。
安裝完成後,登錄賬戶:使用GitHub、Google或郵箱創建/登錄Cursor賬戶,Cursor會自動啟動並顯示配置界面。
3. 初始配置
鍵盤佈局選擇:根據個人習慣選擇Vim或Emacs佈局,如果不熟悉可選擇默認的"None",主題選擇:選擇明亮或暗色主題。
隱私設置:如何不希望分享數據給Cursor,可以選擇Privacy Mode。
4. 中文界面設置(可選)
如果希望使用中文界面,可以按照以下步驟操作:
1)使用拓展程序設置中文版
打開Cursor軟件,按下鍵盤組合鍵Ctrl+Shift+X,進入拓展程序頁面。在搜索框中輸入“Chinese”,搜索中文語言包。在搜索結果中找到合適的中文語言包,點擊安裝。安裝完成後,重啟Cursor軟件,即可看到軟件界面已經成功切換為中文。
2)配置語言設置中文版
打開Cursor軟件,按下鍵盤組合鍵Ctrl+Shift+P,打開命令面板。在命令面板的搜索框中輸入“configure display language”,按下回車鍵。
在彈出的語言配置頁面中,選擇“中文(簡體)”作為顯示語言。點擊“保存”按鈕,重啟Cursor軟件,即可看到軟件界面已經成功切換為中文。
三、MCP配置步驟
要在Cursor中使用MCP功能,需要先完成MCP服務器的配置。以下是詳細步驟:
1. 基礎環境準備
在配置MCP之前,確保您的系統中已安裝以下組件:
- Node.js:版本≥14(驗證方法:在命令行中輸入
node -v
查看版本號) - Git:最新穩定版本
- Python:部分MCP服務需要Python3.10或更高版本(可選)
2. 訪問Cursor MCP設置
打開Cursor設置,可以通過以下兩種方式:
1)點擊右上角齒輪圖標也就是“設置”選項,在出現的左側菜單中找到並點擊“MCP”。
2)在搜索框中,使用快捷鍵Ctrl+Shift+P
(Windows/Linux)或Cmd+Shift+P
(Mac)打開命令面板,搜索"Cursor Settings",在左側菜單中找到並點擊“MCP”。
3. 添加MCP服務器
在MCP設置頁面,點擊"+ Add New MCP Server"按鈕,將出現配置窗口:
點擊添加之後,會出現一個編輯框,輸入MCP 服務的配置代碼。
官方示例:這裡MCP 配置文件使用具有以下結構的 JSON 格式:
4. 配置Web搜索MCP服務(示例)
以下是配置Web搜索MCP服務的具體步驟:
訪問魔塔社區MCP廣場:https://modelscope.cn/mcp,比如選擇"fetch網頁內容抓取"這個服務:
在右側找到並複製Cursor安裝命令:
把命令字段複製進編輯器然後保存即可,這樣上面示例中的"fetch網頁內容抓取"MCP服務就添加成功了。
5. 驗證MCP服務器狀態
添加完成後,就可以看到目錄下新增一個“fetch”mcp服務,MCP服務器應顯示為可用狀態。成功配置的MCP服務器會在列表中顯示綠色指示燈或勾號。
類似的方法,AIbase在本示例轉給你還添加了另外一個可以生成圖片的MCP服務“fal ai”,後面可以搭配使用。
四、使用MCP功能
要使用已配置的MCP功能,需要注意以下幾點:
1. 使用限制
重要提示:目前MCP工具並非適用於所有模型,僅在Composer中的Agent處可用。在新版Cursor中,Composer被移至聊天框的左下角,並改名為"Edit"。
2. 測試MCP功能
打開Cursor的聊天功能,使用以下步驟測試MCP:
1)在聊天框中點擊左下角的"Edit"按鈕切換到Agent模式,接下去就是在聊天框中輸入相關指令,測試MCP工具是否能正常調用。
2)進入Agent模式聊天窗口,輸入指令觀察Cursor是否調用了相應的MCP工具並返回結果,成功調用MCP工具時,會顯示"Called MCP tool"的提示。
下面AIbase具體演示一下實現效果,聊天窗口輸入一個鏈接“https://www.chinaz.com/ainews/17410.shtml”,提示詞為用“200個字總結文章內容並給出標題”。工具會自動調用“fetch”mcp服務,生成效果下圖:
我們再配合生圖的MCP服務,要求為生成的內容配圖,指令輸入“最終文章內容使用tailwindcss+html格式渲染出來。”
這時,工具會自動調用“fal ai”MCP服務,最後會根據指令要求生成html頁面內容。本案例中,我們把這串代碼複製,用在html線運行展示,可以看到已經為內容配上圖片了,大致如下:
五、常見問題及解決方法
1. MCP服務器連接失敗
如果MCP服務器顯示為不可用狀態,請嘗試以下解決方法:
檢查環境依賴:確保Node.js、Git等必要組件已正確安裝
終端執行命令:將MCP命令複製到系統終端中執行,查看是否有詳細的錯誤信息
重啟Cursor:完全關閉並重新啟動Cursor
更新Cursor:確保使用最新版本的Cursor
2. 命令執行超時
有時MCP配置會依賴其他包環境,下載需要一定時間。如果在Cursor規定時間限制內沒有完成連接就會報錯,此時需要:
將命令複製到命令行終端
在終端執行成功後再回到Cursor刷新狀態
3. MCP工具不顯示
如果已配置的MCP工具沒有在調用列表中顯示,可能是因為:
當前不在Agent模式:確保在聊天界面中切換到Edit(原Composer)模式
工具列表未更新:嘗試刷新MCP服務器列表
服務器未啟動:檢查MCP服務器狀態是否為活躍狀態
總結
通過本教程,我們詳細介紹了Cursor編輯器的安裝步驟和MCP服務的配置方法。MCP協議的出現為AI工具提供了強大的擴展能力,使Cursor不僅是一個代碼編輯器,更成為了一個功能豐富的AI開發環境。
隨著MCP生態的不斷發展,越來越多的服務將被接入,進一步增強Cursor的功能。希望本教程能幫助您快速上手Cursor和MCP,提高開發效率。
記住,在使用MCP功能時,一定要在Cursor的Composer/Edit模式下操作,這樣才能成功調用MCP工具。如果遇到問題,可以嘗試本教程中提供的常見問題解決方法,或查閱官方文檔獲取更多支持。
MCP客戶端入門使用教程系列
《適合小白的MCP入門指南,看完這篇0基礎學會使用MCP服務》
《MCP客戶端入門使用教程之Cherry Studio安裝配置》