北京
周三下午三點多，我在調(diào)試自己寫的課程目錄MCP服務器?？刂婆_里一條記錄讓我停了手——這明顯是個讀操作，我卻做成了Tool。改完代碼的那一刻，我決定先把這事記下來，免得半個月后自己又犯同樣的錯。
MCP這個東西，全稱叫模型上下文協(xié)議，本質(zhì)上是個開源標準。它讓Cursor或者Claude桌面版這類AI應用，能按統(tǒng)一的方式去連外部數(shù)據(jù)源和工具。你可以把它想成萬能插座：過去每個編輯器得自己發(fā)明一套接數(shù)據(jù)庫、接接口、接腳本的法子，現(xiàn)在大家都說同一種協(xié)議——JSON-RPC 2.0，跑在標準輸入輸出或者HTTP傳輸上面。Cursor作為客戶端往MCP服務器發(fā)請求，服務器再去找后端的真實數(shù)據(jù)，整個鏈路就是一層適配，MCP并不替代你原來的業(yè)務接口。
協(xié)議對外暴露的能力其實就三種。分清它們之間的區(qū)別，是我寫這篇文章最想聊清楚的事。
第一類叫Tool，可調(diào)用的動作。模型看到用戶說“幫我建一門12小時的NestJS課程”，就會自己去調(diào)用criar_curso這個Tool。每個Tool帶名字、描述、用Zod定義的輸入模式，返回一個結(jié)果。Tool可以有副作用——創(chuàng)建、更新、刪除、發(fā)郵件都行。出錯了還能返回帶isError標記的結(jié)構(gòu)化信息，讓模型自己糾錯。關鍵一條：人得在流程里，無論是審批、看日志還是最后確認。
第二類叫Resource，通過統(tǒng)一資源標識符來訪問的只讀數(shù)據(jù)。cursos://catalogo返回完整目錄，cursos://后面跟一串UUID就能拿到某門課的詳情，甚至file:///docs/guia.md這種靜態(tài)文檔也算。用戶問“現(xiàn)在有哪些課”的時候，要么是模型主動去讀，要么是宿主程序直接把資源內(nèi)容塞進上下文里。它設計上就是只讀的，可以做成固定地址，也能用模板動態(tài)拼出來，宿主程序決定什么時候展示、怎么放進上下文。
第三類叫Prompt，可復用的提示模板。比如/plan-vacation后面跟目的地、天數(shù)、預算這些參數(shù)，引導模型走一遍已知流程。適合需要一致性的重復場景——入職引導、檢查清單、代碼審查流。
回到我自己做的這個課程目錄項目。第二版的時候，我寫了三個Tool：listar_cursos負責讀課程列表，buscar_curso負責查單門課，criar_curso負責寫。前兩個本來就是讀操作，我卻把它倆暴露成了Tool。等到真正跑起來才發(fā)現(xiàn)不對勁——Tool會帶上“可以執(zhí)行動作”的語義暗示，模型偶爾會在不該調(diào)用的時候去調(diào)，甚至在上下文中產(chǎn)生預期之外的交互行為。后來我把listar_cursos和buscar_curso全改成了Resource，只留下criar_curso繼續(xù)當Tool，整個行為立刻穩(wěn)定下來。從概念驗證到能上生產(chǎn)，區(qū)分讀和寫、區(qū)分Resource和Tool，是整件事里最關鍵的一個設計決策。
有個判斷標準我現(xiàn)在一直在用：用戶只是想知道有什么數(shù)據(jù)，那就是Resource；用戶想讓系統(tǒng)改變點什么，那就是Tool。記住這條，后面選類型的時候基本不出錯。
特別聲明：以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺“網(wǎng)易號”用戶上傳并發(fā)布，本平臺僅提供信息存儲服務。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
