簡(jiǎn)介

本文檔是一份詳細(xì)的 MCP (Model Context Protocol) 入門教程，旨在幫助你快速上手，體驗(yàn) AI 的強(qiáng)大動(dòng)手能力。即使你是技術(shù)小白，跟著本教程也能輕松配置并使用你的第一個(gè) MCP 服務(wù)。

1. 準(zhǔn)備工作

在開始之前，你需要完成以下準(zhǔn)備工作：

1.1 下載并安裝 Cursor

• 訪問(wèn) Cursor 官網(wǎng)下載客戶端： https://www.cursor.com/

• 下載完成后，按照提示進(jìn)行安裝。

• 訪問(wèn) Node.js 官網(wǎng)下載安裝包： https://nodejs.org/

• 下載適合你操作系統(tǒng)的版本，然后按照默認(rèn)設(shè)置完成安裝。

• 驗(yàn)證安裝 (可選):

• 1. 打開你電腦的終端（Windows 上是 "命令提示符 (cmd)" 或 "PowerShell"，macOS 上是 "終端 (Terminal)"）。

  2. 輸入 node -v 并按回車鍵。

  3. 如果終端顯示了 Node.js 的版本號(hào)（例如 v20.11.0 ），則說(shuō)明安裝成功。

現(xiàn)在，我們來(lái)配置 Cursor 以使用 MCP 服務(wù)。

2.1 打開 Cursor 設(shè)置

• 啟動(dòng) Cursor 軟件。

• 找到并打開 "首選項(xiàng)" (Preferences) -> "Cursor Settings"。

• 在設(shè)置界面中，找到 MCP 選項(xiàng)卡。

• 點(diǎn)擊 "Add a new global MCP server"。

• 如果是首次配置，Cursor 會(huì)提示你創(chuàng)建一個(gè) mcp.json 文件。點(diǎn)擊 **創(chuàng)建 (Create)**。這個(gè)文件將作為你的 MCP "工具清單"。

• 將以下 JSON 配置代碼完整復(fù)制并粘貼到剛剛創(chuàng)建的 mcp.json 文件中。

  注意: 這份配置包含了多個(gè)預(yù)設(shè)的 MCP 工具，例如：深度思考、網(wǎng)頁(yè)內(nèi)容獲取、本地文件操作、中文平臺(tái)熱搜、網(wǎng)頁(yè)自動(dòng)化、Hacker News 新聞獲取、DuckDuckGo 搜索等。

{   "mcpServers": {     "@smithery-ai-server-sequential-thinking": {       "command": "cmd",       "args": [         "/c",         "npx",         "-y",         "@smithery/cli@latest",         "run",         "@smithery-ai/server-sequential-thinking",         "--config",         "{}"       ]     },     "files": {       "command": "cmd",       "args": [         "/c",         "npx",         "-y",         "@modelcontextprotocol/server-filesystem",         "D:/aiboshihaihai"       ]     },       "@wopal-mcp-server-hotnews": {         "command": "cmd",         "args": [           "/c",           "npx",         "@wopal/mcp-server-hotnews"         ]       },           "playwright": {         "command": "cmd",         "args": [           "/c",           "npx",           "-y",           "@executeautomation/playwright-mcp-server"         ]     }   } }

• 特別注意: 在名為 "files" 的工具配置中，你需要將 "C:/Users/Administrator/Desktop" 修改為你實(shí)際希望允許 AI 訪問(wèn)和操作的本地文件夾路徑。例如，如果你想讓 AI 操作 D 盤下的 AI_Work 文件夾，就修改為 "D:/AI_Work" 。請(qǐng)謹(jǐn)慎設(shè)置此路徑，確保只授予必要的權(quán)限。

• 保存 mcp.json 文件。

• 回到 Cursor 的 MCP 設(shè)置界面。

• 你應(yīng)該能看到剛才配置的各個(gè) MCP 服務(wù)列表。

• 如果服務(wù)名稱前面顯示綠色對(duì)勾 ?，表示該服務(wù)已成功加載并準(zhǔn)備就緒。

• 如果沒有顯示綠燈或加載失敗，請(qǐng)嘗試點(diǎn)擊旁邊的 刷新 (Refresh) 按鈕。如果問(wèn)題仍然存在，請(qǐng)檢查 mcp.json 文件內(nèi)容是否正確復(fù)制粘貼，以及 Node.js 是否正確安裝。

配置完成后，你就可以在 Cursor 中使用這些強(qiáng)大的 MCP 工具了。

3.1 切換到 Agent 模式

在 Cursor 的聊天界面，確保頂部的模式切換到 Agent 模式。只有在 Agent 模式下，AI 才能調(diào)用 MCP 工具。

3.2 查詢可用工具

向 Agent 提問(wèn)，了解當(dāng)前可用的工具及其功能：

我現(xiàn)在有哪些可用的 MCP 工具？它們分別能做什么？

• AI 會(huì)列出它所擁有的"工具"以及每個(gè)工具的"說(shuō)明書"（即功能描述）。

現(xiàn)在，你可以向 Agent 下達(dá)需要調(diào)用特定工具才能完成的任務(wù)了。以下是一些示例：

• 示例 1：網(wǎng)頁(yè)信息提取與分析 (需要 Playwright 或 Fetch 工具)

  幫我去打開這個(gè)B站主頁(yè) https://space.bilibili.com/3546706616518839?spm_id_from=333.1387.0.0，把其視頻播放量和標(biāo)題都記下來(lái)，分析高播放量?jī)?nèi)容主題和標(biāo)題的風(fēng)格特點(diǎn)，并將結(jié)果保存到'D:/aiboshihaihai'的 AI博士嗨嗨分析.html 文件中。

• 示例 2：結(jié)合熱搜和文件操作

  幫我根據(jù)今天的知乎熱榜寫一個(gè)關(guān)于知乎熱榜日?qǐng)?bào)，并將內(nèi)容保存到'D:/aiboshihaihai'的 知乎快訊日?qǐng)?bào).txt 文件中。

• 示例 3：文件管理

  將 D 盤 D:/aiboshihaihai 文件夾里的所有文件名按順序改成 AI博士嗨嗨1.pdf, AI博士嗨嗨2.docx ... 這樣的格式。(請(qǐng)注意：執(zhí)行此類操作前，請(qǐng)務(wù)必確認(rèn) "files" 工具配置的路徑正確，并了解其潛在風(fēng)險(xiǎn))

• 示例 4：結(jié)合搜索和網(wǎng)頁(yè)自動(dòng)化 (需要搜索和 Playwright 工具)

  搜索最新的AI大模型領(lǐng)域新聞，訪問(wèn)排名前三的新聞鏈接，總結(jié)每篇文章的核心觀點(diǎn)，并將結(jié)果整理成中文報(bào)告。

自動(dòng)運(yùn)行模式:

• 為了避免每次 AI 調(diào)用工具時(shí)都彈出確認(rèn)框，可以進(jìn)入 Cursor Settings -> "Features" -> "Agent"。

• 打開 "auto-run mode" 開關(guān)。

安全設(shè)置:

• 如果你擔(dān)心 AI 誤操作執(zhí)行危險(xiǎn)命令（尤其是在開啟自動(dòng)運(yùn)行模式后），可以在 "Agent" 設(shè)置下方的 "Disallowed commands" 區(qū)域添加需要禁止的命令，例如 rm -f (強(qiáng)制刪除文件)。

想要探索更多強(qiáng)大的 MCP 工具？可以訪問(wèn) MCP 工具聚合網(wǎng)站：

• Smithery.ai: https://smithery.ai/

在這里你可以找到社區(qū)貢獻(xiàn)的各種 MCP 服務(wù)器，并將它們添加到你的 mcp.json 配置中。

5. 補(bǔ)充案例：添加高德地圖 MCP 服務(wù)

以下是如何添加一個(gè)使用高德地圖 API 進(jìn)行路線規(guī)劃的 MCP 服務(wù)示例。

5.1 獲取高德地圖 API Key

1. 訪問(wèn) 高德開放平臺(tái) 控制臺(tái)并登錄：https://console.amap.com/

2. 在左側(cè)導(dǎo)航欄選擇 "應(yīng)用管理" -> "我的應(yīng)用"。

3. 點(diǎn)擊 "創(chuàng)建新應(yīng)用"，填寫應(yīng)用名稱和類型。

4. 創(chuàng)建應(yīng)用成功后，進(jìn)入該應(yīng)用的詳情頁(yè)。

5. 點(diǎn)擊 "添加 Key" 按鈕。

6. 選擇 "Web服務(wù)" 類型的 Key，填寫 Key 的名稱，并根據(jù)需要設(shè)置 IP 白名單（如果留空則不限制 IP）。

7. 創(chuàng)建成功后，你將獲得一個(gè) Key。請(qǐng)妥善保管這個(gè) Key。

   注意： 24小時(shí)內(nèi)申請(qǐng)的 Key 不允許刪除。

1. 在 Cursor 的聊天界面，確保頂部的模式切換到 Agent 模式。

2. 重要： 將代碼中的 "您在高德官網(wǎng)上申請(qǐng)的key" 替換為你實(shí)際申請(qǐng)到的高德地圖 Key。

{   "mcpServers": {     "amap-amap-sse": {       "url": "https://mcp.amap.com/sse?key=您在高德官網(wǎng)上申請(qǐng)的key"     }   } }

1. 保存 mcp.json 文件。

2. 回到 Cursor 的 MCP 設(shè)置界面，點(diǎn)擊刷新按鈕，檢查新添加的高德地圖服務(wù)是否顯示綠燈 ?。

3. 現(xiàn)在，你可以在 Agent 模式下向 AI 發(fā)出與路線規(guī)劃相關(guān)的指令了：

我在北京大興機(jī)場(chǎng)，女朋友在首都國(guó)際機(jī)場(chǎng)，請(qǐng)用高德地圖推薦一個(gè)位于我們中間的商業(yè)街區(qū)（要求交通便利，適合見面），并列出該商業(yè)街排名前三的火鍋店，同時(shí)提供從兩個(gè)機(jī)場(chǎng)分別前往的公共交通或駕車路線。

希望這篇教程對(duì)你有幫助！記得點(diǎn)贊、收藏、關(guān)注！