做AI應(yīng)用這段時(shí)間我最大的感受是模型能力已經(jīng)不再是瓶頸真正卡脖子的是數(shù)據(jù)進(jìn)不來(lái)、工具調(diào)不動(dòng)。你訓(xùn)練一個(gè)再聰明的模型它也沒(méi)法自己讀你公司的PostgreSQL沒(méi)法自己操作Figma沒(méi)法自己查藍(lán)湖里的設(shè)計(jì)稿。直到MCPModel Context Protocol出現(xiàn)這種每個(gè)應(yīng)用各搞一套接口的混沌狀態(tài)才算有了收斂的趨勢(shì)。MCP說(shuō)白了就是給AI接外部世界的通用接口它用一種標(biāo)準(zhǔn)化的方式讓AI應(yīng)用能夠發(fā)現(xiàn)、協(xié)商、調(diào)用外部工具和數(shù)據(jù)源。這篇文章我不打算復(fù)述官方文檔而是從開(kāi)發(fā)者的視角把MCP的架構(gòu)、實(shí)操、邊界和坑一次性講透。1. 接口的戰(zhàn)國(guó)時(shí)代為什么AI接個(gè)數(shù)據(jù)這么費(fèi)勁1.1 回看沒(méi)有MCP的日子每個(gè)集成都是一次性代碼在MCP出現(xiàn)之前AI應(yīng)用接入外部數(shù)據(jù)源是一件非常原始的事情。我做過(guò)的第一個(gè)內(nèi)部知識(shí)庫(kù)問(wèn)答助手公司里同時(shí)用了飛書(shū)文檔、Confluence、MySQL還有一套自研的工單系統(tǒng)。為了讓模型能回答某個(gè)功能最近被吐槽最多的是什么這類(lèi)問(wèn)題我一個(gè)人寫(xiě)了四套完全不同的適配代碼飛書(shū)要過(guò)開(kāi)放平臺(tái)的權(quán)限校驗(yàn)Confluence要處理分頁(yè)和富文本格式MySQL要自己拼查詢(xún)并做表結(jié)構(gòu)文檔化工單系統(tǒng)更是連一個(gè)正經(jīng)的API文檔都沒(méi)有全靠抓包逆向。這不是我一個(gè)人的處境是當(dāng)時(shí)整個(gè)行業(yè)的狀態(tài)。每一家做AI應(yīng)用的團(tuán)隊(duì)都在重復(fù)造輪子。模型側(cè)呢OpenAI有Function CallingAnthropic有Tool UseGoogle也有自己的Function Calling每個(gè)平臺(tái)的定義方式、調(diào)用約束、返回格式都不一樣。你一旦選定了某個(gè)模型供應(yīng)商對(duì)接外部工具的代碼就跟這個(gè)供應(yīng)商深度綁定想換一個(gè)模型等于把集成層重寫(xiě)一遍。這就像家里每個(gè)電器都自帶一根專(zhuān)用的插頭插座不通用線(xiàn)纜不通用連電壓都不一樣每次買(mǎi)新電器都得重新走線(xiàn)。1.2 AI應(yīng)用的USB接口這個(gè)類(lèi)比怎么理解MCP要解決的就是這個(gè)問(wèn)題。大家喜歡把MCP比作AI界的Type-C接口這個(gè)類(lèi)比其實(shí)非常貼切。Type-C的特點(diǎn)是什么一個(gè)物理接口標(biāo)準(zhǔn)既能傳數(shù)據(jù)又能充電所有支持它的設(shè)備不用管對(duì)面是不是同一個(gè)廠(chǎng)商插上就能用。MCP做的事情本質(zhì)上是一樣的它定義了AI應(yīng)用Host和外部能力Server之間的標(biāo)準(zhǔn)對(duì)話(huà)方式這個(gè)對(duì)話(huà)方式包括你是誰(shuí)、你能做什么、我怎么調(diào)用你、你返回的結(jié)果長(zhǎng)什么樣。一個(gè)支持MCP的AI客戶(hù)端就像一臺(tái)帶Type-C口的筆記本。你可以隨時(shí)插上U盤(pán)文件系統(tǒng)Server、網(wǎng)卡HTTP請(qǐng)求Server、顯示器瀏覽器操作Server不需要為每一個(gè)外設(shè)單獨(dú)裝驅(qū)動(dòng)。對(duì)整個(gè)生態(tài)來(lái)說(shuō)這是從私有協(xié)議到公共標(biāo)準(zhǔn)的一次躍遷。這個(gè)協(xié)議最早由Anthropic提出并開(kāi)源但現(xiàn)在已經(jīng)不是某一家公司的私有物而是被OpenAI、Google、微軟等主流廠(chǎng)商陸續(xù)接納的開(kāi)放標(biāo)準(zhǔn)。生態(tài)里的任何一方只要愿意遵守這個(gè)協(xié)議就能跟所有遵守同一協(xié)議的另外一方互聯(lián)互通。1.3 核心設(shè)計(jì)動(dòng)機(jī)模型需要的不是連接是上下文這里特別想強(qiáng)調(diào)一個(gè)容易被人忽略的動(dòng)機(jī)。很多人以為MCP是為了讓AI更強(qiáng)大但更準(zhǔn)確地說(shuō)MCP是為了讓AI有東西可以思考。大模型本質(zhì)上是一個(gè)推理引擎你給它什么上下文它就在什么上下文里推理。工具調(diào)用、資料檢索、數(shù)據(jù)庫(kù)查詢(xún)……這些能力的本質(zhì)都是在模型推理的那一瞬間把外部世界的真實(shí)數(shù)據(jù)搬運(yùn)到它的上下文窗口里。所以MCP協(xié)議全稱(chēng)里那個(gè)Context不是隨便起的。它要傳輸?shù)慕^不僅僅是工具調(diào)用的結(jié)果而是整個(gè)上下文相關(guān)的數(shù)據(jù)、狀態(tài)和反饋。這個(gè)設(shè)計(jì)動(dòng)機(jī)理解透了后面的很多決策——比如為什么要區(qū)分Resources和Tools、為什么工具描述要寫(xiě)得詳細(xì)——你都會(huì)自然明白。很多人在使用過(guò)程中工具總是調(diào)用失敗根子上的原因就是沒(méi)有站在喂給模型上下文的角度去設(shè)計(jì)Server而是站在完成一個(gè)函數(shù)調(diào)用的角度去設(shè)計(jì)。2. MCP架構(gòu)拆解Host、Client和Server的分工沒(méi)有你想象中復(fù)雜2.1 一次完整通信的旅程從用戶(hù)提問(wèn)到工具返回MCP的架構(gòu)聽(tīng)起來(lái)名詞很多Host、Client、Server但拆開(kāi)看就那么點(diǎn)事。我結(jié)合一個(gè)真實(shí)場(chǎng)景來(lái)講。假設(shè)你正在使用一個(gè)支持MCP的AI助手你問(wèn)它幫我查一下上個(gè)月華東區(qū)的訂單總量。 背后發(fā)生的事情是HostAI助手應(yīng)用收到你的問(wèn)題把這個(gè)問(wèn)題連同系統(tǒng)提示詞一起發(fā)給接入的大模型。模型在推理時(shí)發(fā)現(xiàn)要回答這個(gè)問(wèn)題它缺少訂單數(shù)據(jù)——它需要一個(gè)查詢(xún)訂單數(shù)據(jù)庫(kù)的能力。這個(gè)能力從哪里來(lái)Host里注冊(cè)了一個(gè)MCP Client這個(gè)Client連接著一個(gè)MCP Server也就是你提前配置好的訂單數(shù)據(jù)庫(kù)服務(wù)。Client做的事情相當(dāng)于一個(gè)翻譯官它把模型想調(diào)用工具這個(gè)意圖用MCP協(xié)議規(guī)定的格式JSON-RPC消息發(fā)給Server詢(xún)問(wèn)你有哪些工具可以調(diào)用。Server返回自己暴露的工具列表以及每個(gè)工具的參數(shù)說(shuō)明。這段說(shuō)明在MCP里叫Tool Schema是用JSON Schema描述的。模型看到工具列表決定調(diào)用query_orders這個(gè)工具并填上參數(shù)region華東、month2024-11。Client把調(diào)用請(qǐng)求轉(zhuǎn)發(fā)給ServerServer執(zhí)行真實(shí)的SQL查詢(xún)將結(jié)果返回給Client。Client再把結(jié)果交給模型模型基于這份真實(shí)數(shù)據(jù)組織出自己的語(yǔ)言回答。整個(gè)鏈路里模型始終沒(méi)有直接跟數(shù)據(jù)庫(kù)打交道它只跟上下文里的描述打交道。數(shù)據(jù)庫(kù)在哪、用什么驅(qū)動(dòng)、SQL怎么寫(xiě)全部被Server屏蔽掉了。這正是通用接口的意義模型和工具之間不再是一對(duì)一定制化連接而是通過(guò)標(biāo)準(zhǔn)協(xié)議自由組合。2.2 三個(gè)核心對(duì)象Tools、Resources和PromptsMCP協(xié)議里有三個(gè)核心對(duì)象我管它們叫手、眼、記憶。Tools手模型可以主動(dòng)觸發(fā)的動(dòng)作比如發(fā)送HTTP請(qǐng)求寫(xiě)入文件執(zhí)行SQL。工具是有副作用的模型在推理時(shí)會(huì)自主決定是否調(diào)用。每個(gè)工具都需要通過(guò)JSON Schema描述參數(shù)。要把工具的用途、參數(shù)含義寫(xiě)得讓模型清楚這是MCP Server開(kāi)發(fā)中最影響效果的一點(diǎn)。Resources眼模型可以主動(dòng)讀取的數(shù)據(jù)比如一個(gè)文件的內(nèi)容、一張表的結(jié)構(gòu)、一份配置。Resources通常沒(méi)有副作用是只讀的。跟工具不同Resources更像是給模型提供的參考資料可以讓模型在行動(dòng)之前先了解情況。比如讓AI做數(shù)據(jù)分析之前先給它讀一遍表結(jié)構(gòu)說(shuō)明它后面寫(xiě)查詢(xún)語(yǔ)句的準(zhǔn)確率會(huì)明顯上升。Prompts記憶MCP Server可以向客戶(hù)端暴露一些預(yù)設(shè)好的提示詞模板類(lèi)似給這個(gè)場(chǎng)景定制好的開(kāi)場(chǎng)指令?？蛻?hù)端可以把這些模板當(dāng)作功能入口展示給用戶(hù)。這個(gè)設(shè)計(jì)適合把某個(gè)領(lǐng)域的專(zhuān)家知識(shí)沉淀在Server里比如法律文件審查流程編程代碼審查清單。三者對(duì)比對(duì)象生命周期副作用誰(shuí)觸發(fā)典型場(chǎng)景Tools調(diào)用時(shí)有模型自主觸發(fā)查詢(xún)訂單、發(fā)郵件、執(zhí)行命令Resources讀取時(shí)無(wú)模型按需讀取讀取表結(jié)構(gòu)、加載文件、查看配置Prompts觸發(fā)時(shí)無(wú)客戶(hù)端引導(dǎo)或用戶(hù)選擇預(yù)設(shè)審查流程、角色設(shè)定2.3 傳輸層里的stdio和SSE到底是什么區(qū)別MCP協(xié)議在傳輸層給了兩種標(biāo)準(zhǔn)實(shí)現(xiàn)stdio和SSEServer-Sent Events。對(duì)于剛接觸MCP的人這兩個(gè)詞有點(diǎn)勸退其實(shí)一句話(huà)就能說(shuō)清。stdio標(biāo)準(zhǔn)輸入輸出Server作為客戶(hù)端的一個(gè)子進(jìn)程運(yùn)行雙方通過(guò)標(biāo)準(zhǔn)輸入和標(biāo)準(zhǔn)輸出互相傳遞消息。所有數(shù)據(jù)都發(fā)生在本地進(jìn)程之間不走網(wǎng)絡(luò)。優(yōu)點(diǎn)是簡(jiǎn)單、安全、無(wú)網(wǎng)絡(luò)開(kāi)銷(xiāo)適合綁定在本機(jī)上的工具比如讀取本地文件、運(yùn)行本地腳本、操作本地?cái)?shù)據(jù)庫(kù)。SSE服務(wù)器推送事件Server是一個(gè)遠(yuǎn)程HTTP服務(wù)客戶(hù)端通過(guò)HTTP連接到它服務(wù)端通過(guò)SSE通道向客戶(hù)端持續(xù)推送事件。優(yōu)點(diǎn)是Server可以部署在中心機(jī)房多個(gè)客戶(hù)端共享同一個(gè)服務(wù)適合團(tuán)隊(duì)共享的數(shù)據(jù)服務(wù)比如統(tǒng)一的Git倉(cāng)庫(kù)操作服務(wù)、統(tǒng)一的數(shù)據(jù)庫(kù)查詢(xún)服務(wù)。實(shí)際開(kāi)發(fā)中的選型原則也很簡(jiǎn)單如果你是給個(gè)人電腦上的AI助手裝一個(gè)讀寫(xiě)本地文件的工具用stdio就夠了如果你要給整個(gè)團(tuán)隊(duì)提供一個(gè)查公司訂單數(shù)據(jù)庫(kù)的服務(wù)那必須用SSE否則每個(gè)同事的電腦上都要配置一份數(shù)據(jù)庫(kù)憑據(jù)想想都頭大。3. 從零寫(xiě)一個(gè)MCP ServerPython官方SDK完整實(shí)操3.1 為什么我用Python官方SDK而不是Node或者直接用JSON-RPC現(xiàn)在實(shí)現(xiàn)MCP Server的路徑有三條直接用官方TypeScript SDK、用官方Python SDK、或者完全自己手寫(xiě)JSON-RPC協(xié)議通信。我給的建議是如果沒(méi)有特殊的生態(tài)綁定需求優(yōu)先用Python官方SDK里的FastMCP。原因有三。第一FastMCP把協(xié)議細(xì)節(jié)封裝得非常好一個(gè)裝飾器就能暴露一個(gè)工具入門(mén)成本極低三五分鐘就能跑通一個(gè)能用的Server。第二AI工具生態(tài)里Python的存量最大你的Server如果不止接AI客戶(hù)端還想自己做數(shù)據(jù)清洗、調(diào)模型、跑分析Python都能無(wú)縫銜接。第三官方SDK的維護(hù)質(zhì)量和社區(qū)活躍度目前是最高的遇到問(wèn)題基本能在GitHub Issues或社區(qū)里找到現(xiàn)成答案。我的環(huán)境建議Python 3.10以上用uv管理依賴(lài)。uv可以直接通過(guò)pip install uv安裝然后uv init初始化項(xiàng)目。如果你不想引入uv用venv加pip也可以下面的代碼完全兼容。整個(gè)項(xiàng)目的依賴(lài)其實(shí)就兩個(gè)包mcp和psutilpsutil用來(lái)獲取系統(tǒng)信息換成別的第三方庫(kù)也完全無(wú)所謂。3.2 一個(gè)能查詢(xún)系統(tǒng)信息的最小Server下面這個(gè)Server麻雀雖小但五臟俱全它暴露了兩個(gè)工具一個(gè)獲取CPU信息一個(gè)獲取系統(tǒng)內(nèi)存狀態(tài)。雖然業(yè)務(wù)價(jià)值一般但足夠你把MCP Server的開(kāi)發(fā)鏈路完整走一遍。import platform import psutil from mcp.server.fastmcp import FastMCP # 創(chuàng)建MCP Server實(shí)例名字會(huì)出現(xiàn)在客戶(hù)端配置里 mcp FastMCP(system-info-demo) mcp.tool() def get_cpu_info() - dict: 獲取當(dāng)前機(jī)器的CPU型號(hào)、核數(shù)等基礎(chǔ)信息 return { processor: platform.processor(), core_count: psutil.cpu_count(logicalTrue), physical_cores: psutil.cpu_count(logicalFalse), arch: platform.machine(), system: platform.system(), release: platform.release(), } mcp.tool() def get_memory_info() - dict: 獲取當(dāng)前機(jī)器的內(nèi)存總量、已用、可用情況 mem psutil.virtual_memory() return { total: mem.total, available: mem.available, used: mem.used, percent: mem.percent, } if __name__ __main__: # stdio傳輸模式供本地客戶(hù)端調(diào)用 mcp.run(transportstdio)可以注意幾個(gè)細(xì)節(jié)。第一工具函數(shù)上的docstring不是擺設(shè)這個(gè)字符串會(huì)被當(dāng)作工具的說(shuō)明傳給模型。模型判斷這個(gè)工具是干什么的、什么時(shí)候該用全靠它所以寫(xiě)清楚說(shuō)明效果好一半。第二mcp.run(transportstdio)指定的是本地傳輸模式如果要做遠(yuǎn)程服務(wù)可以改造成SSE方式但具體寫(xiě)法建議用的時(shí)候看一眼當(dāng)前版本SDK的文檔。第三上面的代碼用到了psutil記得用pip install psutil安裝。運(yùn)行方式最簡(jiǎn)單python server.py如果一切正常程序會(huì)靜默地等待標(biāo)準(zhǔn)輸入上的消息什么都不會(huì)打印。這不是卡住了這是Server在等你給它發(fā)MCP協(xié)議消息。很多剛接觸MCP的人在這里會(huì)強(qiáng)行CtrlC以為寫(xiě)錯(cuò)了其實(shí)完全正常。3.3 用MCP Inspector把Server翻個(gè)底朝天MCP官方提供了一個(gè)用來(lái)調(diào)試Server的工具Inspector強(qiáng)烈建議任何寫(xiě)MCP Server的人第一件事先學(xué)會(huì)用它。在項(xiàng)目目錄下執(zhí)行npx modelcontextprotocol/inspector python server.pyInspector會(huì)起一個(gè)本地的Web界面在這個(gè)界面里你能看到Server暴露的所有工具列表、每個(gè)工具的JSON Schema參數(shù)定義還能直接填參數(shù)手動(dòng)調(diào)用工具看響應(yīng)結(jié)果。這一步非常關(guān)鍵它能幫你把Server本身的功能和模型對(duì)工具的使用中間那一層隔離開(kāi)來(lái)。你在調(diào)試時(shí)應(yīng)該先在這里確認(rèn)工具能正常工作再去接入真正的AI客戶(hù)端否則出了問(wèn)題你都分不清是Server的bug還是模型亂調(diào)用。3.4 接入Claude Desktop和Cursor配置文件的那些坑工具寫(xiě)好了接下來(lái)就是讓AI客戶(hù)端真正能調(diào)用到它。不同客戶(hù)端的配置方式大同小異我說(shuō)兩個(gè)最常用的。Claude Desktop的配置在claude_desktop_config.json里macOS下通過(guò)Claude Desktop菜單直接打開(kāi)配置目錄即可內(nèi)容是{ mcpServers: { system-info-demo: { command: python, args: [/absolute/path/to/server.py] } } }Cursor的配置在~/.cursor/mcp.json{ mcpServers: { system-info-demo: { command: python, args: [/absolute/path/to/server.py] } } }這里有幾個(gè)我踩過(guò)的坑必須提醒你。第一command字段里的python一定要確認(rèn)能解析到虛擬環(huán)境。如果你用venv直接寫(xiě)python很可能用的是系統(tǒng)全局Python那個(gè)環(huán)境里根本沒(méi)裝mcp和psutil。最穩(wěn)妥的做法是把command寫(xiě)成虛擬環(huán)境里python的絕對(duì)路徑比如/Users/xxx/.venv/bin/python。第二個(gè)坑是路徑args里的腳本路徑必須是絕對(duì)路徑寫(xiě)相對(duì)路徑會(huì)有奇奇怪怪的找不到文件問(wèn)題。第三個(gè)坑更隱蔽改了配置文件后大多數(shù)客戶(hù)端需要徹底重啟才會(huì)重新加載MCP Server。注意是徹底重啟進(jìn)程不是簡(jiǎn)單地在對(duì)話(huà)里刷新很多人在這一步卡半個(gè)小時(shí)其實(shí)是沒(méi)重啟。4. MCP與Function Calling、Computer Use到底什么關(guān)系4.1 Function Calling不是競(jìng)爭(zhēng)是上下層網(wǎng)上經(jīng)常有人把MCP和Function Calling放在對(duì)立面比較問(wèn)有了Function Calling為什么還要MCP。我的看法是它是兩個(gè)不同層次的標(biāo)準(zhǔn)本身就不該拿來(lái)直接對(duì)比。Function Calling解決的是模型如何輸出一個(gè)結(jié)構(gòu)化意圖的問(wèn)題。它定義了模型在回答時(shí)如何以JSON的形式表達(dá)我想調(diào)用某個(gè)函數(shù)、參數(shù)是什么。它是模型推理能力的一部分發(fā)生在模型推理的那一瞬間到底要不要調(diào)用工具、調(diào)用哪個(gè)工具這是模型的自主決策。MCP解決的是模型想調(diào)用工具時(shí)工具在哪、怎么連、參數(shù)結(jié)構(gòu)怎么定義的問(wèn)題。它管的是調(diào)用意圖生成之后Client和Server之間怎么通信、怎么鑒權(quán)、怎么返回結(jié)果。換句話(huà)說(shuō)Function Calling是大腦里決策的環(huán)節(jié)MCP是執(zhí)行的環(huán)節(jié)。在實(shí)際的MCP鏈路中模型往往正是通過(guò)Function Calling/Tool Use機(jī)制來(lái)表達(dá)調(diào)用意圖的然后Client把這個(gè)意圖翻譯成MCP協(xié)議消息發(fā)給Server。所以?xún)烧呤桥浜鲜褂玫年P(guān)系不是替代關(guān)系。如果一定要打比方Function Calling像運(yùn)輸合同里決定要發(fā)一批什么貨MCP像一套統(tǒng)一的集裝箱標(biāo)準(zhǔn)。集裝箱標(biāo)準(zhǔn)不管你發(fā)什么貨只管什么貨都能裝進(jìn)去、裝上船、到港能卸下來(lái)。沒(méi)有集裝箱也能運(yùn)貨但每一個(gè)港口都要為每一種貨物造專(zhuān)用吊具。這就是MCP的價(jià)值。4.2 Computer Use讓模型當(dāng)人和讓模型當(dāng)系統(tǒng)的差別Computer Use是另一條技術(shù)路線(xiàn)。它讓模型直接操作屏幕界面像人一樣看像素、移動(dòng)鼠標(biāo)、點(diǎn)擊按鈕、敲鍵盤(pán)屬于端到端的視覺(jué)與交互模型能力。MCP是讓模型通過(guò)顯式的、結(jié)構(gòu)化的接口調(diào)用功能Computer Use讓模型通過(guò)模仿人類(lèi)操作來(lái)使用軟件。這兩者的適用邊界差異非常大。如果一個(gè)系統(tǒng)有公開(kāi)的API或者數(shù)據(jù)庫(kù)用MCP明顯更優(yōu)結(jié)構(gòu)清晰、反饋確定、執(zhí)行快、出錯(cuò)成本低。如果對(duì)方是一個(gè)只有GUI、沒(méi)有公開(kāi)接口的舊系統(tǒng)比如一些老式ERP客戶(hù)端那Computer Use幾乎是唯一的路。但這種路代價(jià)也高模型要理解屏幕坐標(biāo)、識(shí)別界面元素、應(yīng)對(duì)各種彈窗和加載狀態(tài)傳統(tǒng)的接口調(diào)用幾十毫秒完成的事情計(jì)算機(jī)視覺(jué)可能要用幾秒鐘而且穩(wěn)定性遠(yuǎn)遠(yuǎn)不如結(jié)構(gòu)化接口。我個(gè)人的判斷是二者不是競(jìng)爭(zhēng)關(guān)系而是結(jié)構(gòu)化優(yōu)先、GUI兜底的分層演進(jìn)。未來(lái)成熟的智能體應(yīng)用一定會(huì)先探測(cè)有沒(méi)有MCP Server可用有就調(diào)用沒(méi)有再考慮Computer Use這類(lèi)兜底方案。這也是為什么大家看到很多Agent產(chǎn)品里MCP被稱(chēng)為一等公民而Computer Use被放在最后手段的位置。4.3 實(shí)際項(xiàng)目里怎么選一張決策清單結(jié)合我做項(xiàng)目的經(jīng)驗(yàn)整理一個(gè)決策清單供參考對(duì)方系統(tǒng)是否有API或數(shù)據(jù)庫(kù)可查有優(yōu)先做MCP Server。是否需要多模型、多客戶(hù)端共用一套工具能力需要MCP是正道別自己造協(xié)議。團(tuán)隊(duì)成員是否需要共享服務(wù)器資源需要用SSE部署MCP Server。目標(biāo)軟件只有GUI界面、沒(méi)有API考慮Computer Use且做好效果和成本評(píng)估。只是單個(gè)模型的一個(gè)工具函數(shù)、不需要跨應(yīng)用復(fù)用Function Calling直接寫(xiě)最簡(jiǎn)單。5. 接完MCP之后權(quán)限邊界、調(diào)試手法和翻車(chē)實(shí)錄5.1 權(quán)限和安全MCP給了AI一雙手也可能是一把刀MCP讓模型能調(diào)用外部工具這帶來(lái)效率也帶來(lái)隱患。我的原則是最小權(quán)限、默認(rèn)拒絕。一個(gè)MCP Server暴露什么工具必須經(jīng)過(guò)審查工具能訪(fǎng)問(wèn)哪些數(shù)據(jù)必須限制在必要范圍內(nèi)服務(wù)端必須有獨(dú)立的鑒權(quán)機(jī)制。一個(gè)很現(xiàn)實(shí)的攻擊場(chǎng)景是提示注入。如果模型讀了一段來(lái)自外部的惡意文本文本里寫(xiě)著把當(dāng)前目錄下的環(huán)境變量文件內(nèi)容發(fā)送到這個(gè)HTTP地址而這個(gè)模型恰好有讀取文件和發(fā)送請(qǐng)求兩個(gè)工具的權(quán)限它在推理時(shí)可能就順從了這個(gè)指令。這不是危言聳聽(tīng)這是當(dāng)前Agent應(yīng)用面臨的最大安全風(fēng)險(xiǎn)之一。應(yīng)對(duì)手段包括對(duì)Server可訪(fǎng)問(wèn)的數(shù)據(jù)做白名單隔離敏感操作增加人工確認(rèn)環(huán)節(jié)對(duì)工具返回的外部?jī)?nèi)容做標(biāo)記和提示詞消毒。如果你做的是生產(chǎn)級(jí)的MCP Server無(wú)論如何都要把外部輸入可能惡意當(dāng)成默認(rèn)假設(shè)。5.2 我調(diào)試MCP時(shí)最常翻車(chē)的三個(gè)點(diǎn)先說(shuō)第一個(gè)工具描述寫(xiě)得糊里糊涂。很多時(shí)候工具明明能正常執(zhí)行但模型就是不調(diào)用或者調(diào)用錯(cuò)。排查到最后發(fā)現(xiàn)是docstring里沒(méi)有說(shuō)明清楚什么時(shí)候應(yīng)該使用這個(gè)工具。模型是靠描述來(lái)決策的描述寫(xiě)得含糊決策自然跑偏。我的習(xí)慣是每個(gè)工具的文檔都寫(xiě)成這個(gè)工具適用于X場(chǎng)景不適用于Y場(chǎng)景典型參數(shù)格式是Z這樣的句式。第二個(gè)翻車(chē)點(diǎn)返回結(jié)果過(guò)于原始。不少新手寫(xiě)Server時(shí)返回的是直接把數(shù)據(jù)庫(kù)查詢(xún)的原始結(jié)果丟回去。但大模型推理時(shí)對(duì)字段名的理解完全依賴(lài)上下文措辭。你把一條數(shù)據(jù)庫(kù)記錄原樣丟回去模型要猜cust_id是什么意思、dt是日期還是別的什么。更好的做法是返回已經(jīng)整理過(guò)的、面向回答問(wèn)題的結(jié)構(gòu)。比如查訂單直接返回2024-11華東區(qū)訂單總數(shù)286單總金額42.5萬(wàn)元模型幾乎不需要二次推理就能準(zhǔn)確回答。這個(gè)習(xí)慣對(duì)最終輸出質(zhì)量影響巨大。第三個(gè)翻車(chē)點(diǎn)沒(méi)做超時(shí)和降級(jí)。MCP Server偶爾會(huì)慢比如網(wǎng)絡(luò)請(qǐng)求對(duì)方超時(shí)。如果你的Host側(cè)沒(méi)有超時(shí)處理整個(gè)對(duì)話(huà)會(huì)被卡住體驗(yàn)極其糟糕。在設(shè)計(jì)Server時(shí)要對(duì)可能慢的工具設(shè)置合理超時(shí)對(duì)失敗請(qǐng)求返回明確的錯(cuò)誤原因狀態(tài)異常時(shí)寧可告訴模型查詢(xún)暫時(shí)不可用也不要用一個(gè)空泛的錯(cuò)誤信息讓它猜。5.3 從能跑到好用的幾個(gè)進(jìn)階技巧第一把一個(gè)大的萬(wàn)能工具拆成多個(gè)語(yǔ)義單一的小工具。模型選擇工具時(shí)靠的是描述匹配。你給一個(gè)工具起名叫execute把讀寫(xiě)、查詢(xún)?nèi)M(jìn)去模型根本不知道該在什么場(chǎng)景用它。反過(guò)來(lái)拆成query_orders、create_order、cancel_order每個(gè)工具的職責(zé)清清楚楚調(diào)用準(zhǔn)確率會(huì)明顯上升。第二利用Resources讓模型先讀后寫(xiě)。比如做一個(gè)數(shù)據(jù)庫(kù)MCP Server你應(yīng)該先暴露一個(gè)讀取表結(jié)構(gòu)的Resource讓模型在寫(xiě)SQL之前先自動(dòng)讀一遍表結(jié)構(gòu)。這個(gè)小設(shè)計(jì)能大幅降低表名寫(xiě)錯(cuò)、字段不存在這類(lèi)低級(jí)錯(cuò)誤。數(shù)據(jù)驅(qū)動(dòng)的AI應(yīng)用上下文里多給一點(diǎn)結(jié)構(gòu)信息輸出穩(wěn)定性完全是兩個(gè)等級(jí)。第三做好日志。MCP Server的日志比你想象中更重要。在開(kāi)發(fā)階段可以把通信消息直接打到標(biāo)準(zhǔn)錯(cuò)誤流stderr里客戶(hù)端通常會(huì)把stderr原樣呈現(xiàn)調(diào)試信息一目了然。等部署到生產(chǎn)環(huán)境一定要把日志打到獨(dú)立文件并且記錄下每次工具調(diào)用的參數(shù)和耗時(shí)。Agent應(yīng)用出問(wèn)題時(shí)如果拿不到模型當(dāng)時(shí)調(diào)了什么、參數(shù)是什么、返回了什么這三條信息排查基本是瞎猜。做Agent應(yīng)用這段時(shí)間我越來(lái)越覺(jué)得真正決定一個(gè)產(chǎn)品好不好用的往往不是模型的聰明程度而是它周?chē)且蝗A(chǔ)設(shè)施和腳手架。MCP的價(jià)值不在于某一個(gè)工具寫(xiě)得有多巧妙而在于它第一次讓這些工具可以像U盤(pán)一樣即插即用。從個(gè)人項(xiàng)目到團(tuán)隊(duì)協(xié)作從本地工具到云端服務(wù)它把給AI接外部世界這件事從手工作坊變成了流水線(xiàn)生產(chǎn)。你能在模型、數(shù)據(jù)源、用戶(hù)需求這三層之間做好設(shè)計(jì)把每個(gè)接口打磨得干凈、可信、夠用你的AI應(yīng)用就已經(jīng)贏過(guò)大多數(shù)人了。