wen aidev
Published on

MCP (Model Context Protocol) 開發入門01

MCP 開發入門文章架構概覽

MCP 是什麼?

MCP 概覽圖

不懂程式的人來說 最簡單的理解是 MCP如同筆電的 usb插口一樣 用來連接著不同(工具)
筆電=chatgpt or cursor ,電腦的接口=MCP

MCP 就像是「AI 的 USB 隨身碟接口」,讓不同 AI 工具之間可以即插即用。

專業技術解釋

MCP (Model Context Protocol) 是由 Anthropic 自 2024 年 11 月開源推動的 通用、標準化資料接取協議,基於 JSON-RPC 2.0 架構,讓 AI 應用(Host)透過內建的 Client 去連接多個功能專屬的 Server。

MCP 架構圖

MCP 核心組件說明

元件功能說明
MCP HostAI 應用(如 Claude Desktop、IDE),負責管控 context 聚合
MCP Client由 Host 建立,維持與單一 Server 的 JSON‑RPC session,協商功能(capabilities)、路由訊息、通知等
MCP Server輕量級服務,依 MCP 規範公開資源(Resource)、工具(Tool)與提示模板(Prompt)給 Client
Local / Remote Data SourcesServer 端可存取本地檔案系統、資料庫或遠端 API,並在 Host 的授權下讀取或操作資料

簡化理解

MCP 工作流程

所謂的 client server 是相對的意思:工具方永遠叫做MCP server 安裝在本地也一樣 >client=用戶使用的工具,server=工具提供者

1.MCP Host + MCP Clients ⇒ AI IDE(如 Cursor、Claude Desktop)
2.MCP Server ⇒ 各種工具 - Local / Remote
3.Data Sources ⇒ 連接的資料位置

MCP Server 有兩種

1.local 2.Remote services(線上服務)

傳輸方式根據部署位置不同:

  • Local ⇒ stdio 傳輸
  • Remote services ⇒ SSE 傳輸(最新版規範改為HTTP)

這很好理解 就是實際程式運作在本地還是遠端server而已

Cursor 1.0 已支援一鍵安裝

Cursor MCP 整合

Cursor 提供了官方的 MCP 工具目錄:

這些網站收錄的都是 Cursor 官方挑選過的 MCP 工具,並不包含所有可用的 MCP。

尋找更多 MCP 工具

官方資源

第三方平台

  • Smithery.ai:MCP 中介平台,可以直接線上體驗各種 MCP 工具

最簡單的安裝方式:使用 Cline

Cline MCP 安裝界面

推薦使用 Cline 進行 MCP 自動安裝:

  1. 在 VSCode 中安裝 Cline 擴展
  2. 透過 Cline 自動安裝所需的 MCP 工具
  3. 產生的 JSON 配置文件可通用於各種 AI IDE

配置文件格式解析

空的 MCP 配置文件:

{
  "mcpServers": {}
}

安裝 playwright-mcp-server 後的配置:

{
  "mcpServers": {
    "playwright-mcp-server": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

JSON 格式說明

配置文件的結構其實很簡單:

{
  "mcpServers": {
    "工具名稱1": {
      "command": "執行命令",
      "args": ["參數列表"]
    },
    "工具名稱2": {
      "command": "執行命令",
      "args": ["參數列表"],
      "env": {
        "環境變數名": "環境變數值"
      }
    }
  }
}

實際範例:

{
  "mcpServers": {
    "playwright-mcp-server": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    },
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "your_anthropic_key",
        "PERPLEXITY_API_KEY": "your_perplexity_key"
      }
    }
  }
}

配置文件通用性

Cline 產生的 cline_mcp_settings.json 可以直接複製內容到其他 AI IDE:

  • Cursor:叫做 mcp.json可在設定中直接打開修改
  • 其他 AI IDE:格式基本通用,檔名可能略有差異

總結

MCP 核心重點:

  1. 概念理解:MCP 如同電腦的 USB 接口,讓 AI 工具實現即插即用連接
  2. 技術架構:基於 JSON-RPC 2.0 的 Host → Client → Server 三層結構
  3. 開發mcp server =開發給ai用的工具
  4. mcp server部署方式:Local(stdio 傳輸)和 Remote(HTTP 傳輸)兩種模式

支持作者 ☕

台灣用戶:

透過 LINE Pay 支持

國際用戶:

透過 Ko-fi 支持

留言討論