模型上下文協定(MCP)正迅速成為將 AI 代理與外部工具、API 和資料來源連接的標準方式。由 modelcontextprotocol 組織維護的官方 TypeScript SDK,提供了開發者建構 MCP 伺服器所需的一切,用以將功能暴露給 Claude 等 AI 助手。
MCP 建立了 AI 模型與其使用工具之間的標準化介面。無需為每個 AI 代理建構自訂整合,只需建構一個 MCP 伺服器,任何相容 MCP 的客戶端都可以發現並使用你的工具。
SDK 提供的内容
| 元件 | 描述 |
|---|---|
| 伺服器框架 | 建構具有工具、資源和提示處理程式的 MCP 伺服器 |
| 客戶端函式庫 | 從任何 TypeScript 應用程式連接到 MCP 伺服器 |
| 傳輸層 | 內建對 stdio 和 SSE(伺服器傳送事件)的支援 |
| 架構驗證 | 與 Zod 整合的型別安全工具定義 |
| 認證 | OAuth 2.0 和 API 金鑰支援以確保安全連接 |
MCP 架構
flowchart LR
A[AI 客戶端<br/>Claude 等] --> B[MCP 協定<br/>JSON-RPC]
B --> C[MCP 伺服器]
C --> D[工具:計算機]
C --> E[工具:資料庫]
C --> F[工具:網頁搜尋]
C --> G[資源:檔案]
B --> H[傳輸層<br/>stdio / SSE]架構遵循清晰的客戶端-伺服器模式。AI 客戶端透過 JSON-RPC 訊息與 MCP 伺服器通訊,伺服器暴露 AI 可以呼叫的工具和資源。傳輸層處理底層通訊,無論是子程序 stdio 還是網路 SSE。
TypeScript SDK 與其他方案的比較
| 功能 | TypeScript SDK | Python SDK | 自訂整合 |
|---|---|---|---|
| 型別安全 | 完整的 TypeScript 型別 | 透過 Pydantic 型別化 | 手動 |
| 文件 | 優秀 | 優秀 | 無 |
| 社群 | 最大生態系 | 大型生態系 | 無 |
| 設定難易度 | npm install | pip install | 從頭建構 |
| 伺服器範例 | 20+ 個 | 15+ 個 | 零 |
使用 MCP 建構
使用 TypeScript SDK 建立 MCP 伺服器需要將工具定義為型別化的函式。每個工具宣告其輸入架構、描述和處理函式。SDK 會自動處理 JSON-RPC 序列化、錯誤處理和傳輸。這意味著開發者可以專注於業務邏輯,而非協定的底層實作。
如需了解更多,請查看 MCP TypeScript SDK 儲存庫 和 官方 MCP 規範。
常見問題
Q:我是否需要為 MCP 執行單獨的伺服器程序? A:是的,MCP 伺服器作為獨立程序執行,並透過 stdio 或 SSE 與客戶端通訊。
Q:MCP 伺服器可以呼叫其他 MCP 伺服器嗎? A:可以,你可以建構閘道器,將多個 MCP 伺服器聚合在單一端點之後。
Q:MCP 是 Claude 專用的嗎? A:不是,MCP 是一個開放協定,任何 AI 代理或客戶端都可以實作。
Q:SDK 支援哪些認證方法? A:它支援 OAuth 2.0、API 金鑰和自訂認證處理器。
Q:我可以將 MCP 伺服器部署到無伺服器平台嗎? A:可以,SSE 傳輸在無伺服器函式和容器部署中表現良好。
無程式碼也能輕鬆打造專業LINE官方帳號!一鍵導入模板,讓AI助你行銷加分!