MCP協(xié)議是什么?AI代理通用通信協(xié)議詳解與實戰(zhàn)應(yīng)用
MCP:一個“意外誕生”的AI代理通用插座
為什么需要MCP?
用過 VS Code + Cursor + Claude 組合的人大概都踩過這些坑:
- 在 VS Code 里寫完一段 Python,想立刻在 Cursor 里跑單元測試,得手動復(fù)制粘貼;
- Claude 給出的修復(fù)建議沒法直接傳給本地調(diào)試器;
- 每換一個 IDE 就得重寫一遍 Agent 的通信邏輯,連日志格式都要對齊。
MCP 不是為了解決某個宏大命題設(shè)計出來的。它起源于一次深夜調(diào)試——開發(fā)者發(fā)現(xiàn)三個不同平臺的 Agent 正在用三套不兼容的 JSON 字段互相猜意圖,干脆拉出共性,定義了一組最小可行消息結(jié)構(gòu):type、id、payload、tools。沒有抽象層,不包攬調(diào)度,只做一件事:讓 Agent 能聽懂彼此說的話。
協(xié)議本身很輕
它不是插件標(biāo)準(zhǔn)
MCP 是通信協(xié)議,不是 SDK 或框架。它不規(guī)定你用什么語言寫 Agent,也不要求你繼承某個基類。它只約定:
- 所有請求/響應(yīng)必須是 JSON 對象;
- 必須帶
type字段(如"execute_code"、"list_tools"); - 工具調(diào)用必須通過
tools數(shù)組聲明能力,運行時由 Server 決定是否執(zhí)行; - 錯誤統(tǒng)一用
error字段返回,不拋 HTTP 狀態(tài)碼。
VS Code 插件、Claude 的 Tool Use 接口、Cursor 的 Local Agent 都能按這個規(guī)則收發(fā)消息——因為它們本來就在處理 JSON。
跨平臺協(xié)作是自然結(jié)果
不需要“橋接”或“同步狀態(tài)”。只要兩個端點都遵守 MCP,協(xié)作就發(fā)生在線上:
graph LR
A[VS Code Agent] -- POST /mcp --> B[MCP Server]
B -- POST /mcp --> C[Cursor Debugger]
C -- POST /mcp --> D[Claude Reasoner]
D -- POST /mcp --> A比如你在 VS Code 里選中一段代碼,右鍵「發(fā)送到調(diào)試器」,插件會打包成:
{
"type": "execute_code",
"id": "req-7a2f",
"payload": {
"language": "python",
"code": "sum([1, 2, 3])"
}
}Cursor 的 MCP 客戶端收到后直接執(zhí)行,把結(jié)果原樣回傳,VS Code 插件解析 id 匹配原始請求,顯示在終端里。整個過程不依賴共享內(nèi)存、不綁定進程、不強求實時性。
接入成本接近于零
不用改 IDE 源碼,不用等廠商支持。只要你的 Agent 能發(fā) HTTP 請求,就能當(dāng) Client;只要它能監(jiān)聽端口、解析 JSON,就能當(dāng) Server。
已知落地案例:
- 一個 Rust 編寫的本地 LLM 工具鏈,用
reqwest發(fā)請求,50 行代碼接入 Cursor; - 一個 Python 數(shù)據(jù)清洗 Agent,用
Flask暴露/mcp端點,沒動一行業(yè)務(wù)邏輯; - VS Code 插件作者把原有 Language Server 協(xié)議適配層刪掉,換成 MCP 消息轉(zhuǎn)發(fā),發(fā)布周期從兩周縮到兩天。
寫一個可用的 MCP Server
下面這個 Server 能跑通真實交互:接收代碼執(zhí)行請求、返回結(jié)果、處理錯誤。它不追求生產(chǎn)就緒,但每行代碼都有明確目的。
from flask import Flask, request, jsonify
import ast
import traceback
app = Flask(__name__)
@app.route('/mcp', methods=['POST'])
def handle_mcp():
try:
data = request.get_json()
if not data or 'type' not in data:
return jsonify({'error': 'missing type field'}), 400
if data['type'] == 'execute_code':
result = _run_python(data.get('payload', {}))
return jsonify({
'type': 'execute_code_result',
'id': data.get('id'),
'result': result
})
elif data['type'] == 'list_tools':
return jsonify({
'type': 'list_tools_result',
'tools': [
{'name': 'execute_code', 'description': 'Run Python code'}
]
})
else:
return jsonify({'error': f'unsupported type: {data["type"]}'}), 400
except Exception as e:
return jsonify({'error': str(e)}), 500
def _run_python(payload):
code = payload.get('code', '').strip()
if not code:
return {'error': 'empty code'}
# 禁用危險操作,只允許表達式和簡單語句
try:
tree = ast.parse(code, mode='eval')
compiled = compile(tree, '<string>', 'eval')
result = eval(compiled)
return {'output': result}
except SyntaxError:
# 嘗試作為語句執(zhí)行(如賦值、print)
try:
tree = ast.parse(code, mode='exec')
namespace = {}
exec(compile(tree, '<string>', 'exec'), namespace)
output = namespace.get('output') or str(namespace)
return {'output': output}
except Exception as e:
return {'error': traceback.format_exc().split('\n')[-2]}
except Exception as e:
return {'error': str(e)}
if __name__ == '__main__':
app.run(host='127.0.0.1', port=5000, debug=False)啟動和驗證
安裝依賴:
pip install Flask保存為
server.py,運行:python server.py用 curl 測試:
curl -X POST http://localhost:5000/mcp \ -H "Content-Type: application/json" \ -d '{"type":"execute_code","id":"test1","payload":{"code":"2 + 2"}}'
你會得到:
{
"type": "execute_code_result",
"id": "test1",
"result": {"output": 4}
}注意:這個 Server 沒有持久化、沒加認證、沒做資源隔離。但它能讓你看清 MCP 的數(shù)據(jù)流——消息進來,邏輯處理,結(jié)果出去。后續(xù)加固(如超時控制、沙箱執(zhí)行、JWT 驗證)都是可選疊加層。
真實的商業(yè)化路徑
我們見過三個靠 MCP 跑通閉環(huán)的團隊,都不是靠融資或概念炒作:
案例一:前端組件生成器(單人項目)
- 產(chǎn)品:輸入 Figma 鏈接或截圖,輸出 React/Vue 組件代碼 + Storybook 示例;
- MCP 用法:VS Code 插件作為 Client,調(diào)用本地 Python Server(含 OCR + LLM);Server 把截圖發(fā)給私有 Llama 3 實例,再把生成的代碼傳回編輯器;
- 變現(xiàn):GitHub Sponsors + Gumroad 賣 Pro 版(支持 Tailwind 主題定制、Figma 插件直連),月均 $1,800;
- 關(guān)鍵點:沒做 Web UI,全部走編輯器內(nèi)工作流,用戶留存率 67%(vs 行業(yè)平均 22%)。
案例二:運維故障診斷 Agent(小團隊)
- 產(chǎn)品:接入企業(yè) Prometheus + Slack,自動分析告警指標(biāo),生成根因報告;
- MCP 用法:Slack Bot 作為 Client,調(diào)用內(nèi)部 MCP Server;Server 編排多個子 Agent:Prometheus 查詢器、日志檢索器、知識庫檢索器;每個子 Agent 獨立部署,只認 MCP 消息;
- 變現(xiàn):按節(jié)點數(shù)訂閱,$299/月起;已有 12 家中小公司付費;
- 關(guān)鍵點:客戶原有監(jiān)控棧不動,只加一個 MCP Server 和 Slack 插件,上線耗時 < 4 小時。
案例三:學(xué)術(shù)論文輔助工具(學(xué)生團隊)
- 產(chǎn)品:LaTeX 編輯器插件,實時檢查公式語法、查文獻、潤色段落;
- MCP 用法:Overleaf 插件發(fā)請求 → 本地 MCP Server → 調(diào)用 Ollama 的 Phi-3 模型(公式校驗)+ 自建文獻向量庫(相似論文推薦);
- 變現(xiàn):免費基礎(chǔ)版;Pro 版 $5/月,含 PDF 解析、Zotero 同步、批量處理;學(xué)生用戶占比 83%,LTV 達 $22;
- 關(guān)鍵點:所有模型都在本地跑,數(shù)據(jù)不出內(nèi)網(wǎng),高校采購無障礙。
共同規(guī)律:
- 全部繞開大模型 API 廠商的封閉生態(tài);
- 用戶價值錨定在「編輯器內(nèi)完成閉環(huán)」,不是「又一個聊天框」;
- 商業(yè)模式基于具體動作收費(生成組件、診斷故障、潤色段落),而非按 token 或調(diào)用量。
下一步怎么動
別從協(xié)議文檔開始。從這三件事入手:
- 抓包看真實流量:在 VS Code 里裝 MCP Inspector 插件,打開 DevTools Network 標(biāo)簽頁,點「Send to Claude」,看發(fā)了什么、收了什么;
- 改一行代碼跑通:把你現(xiàn)有的 Python 腳本加上上面那個 Flask Server,把
print()換成return jsonify(...),用 curl 調(diào)一次; - 找一個痛點切進去:比如你總要手動把 Jupyter Notebook 單元格內(nèi)容復(fù)制到 Claude,那就寫個 VS Code 命令,選中代碼 → 打包成 MCP 消息 → 發(fā)給本地 Server → 轉(zhuǎn)發(fā)給 Claude API → 把回復(fù)插入編輯器。做完,你就有了第一個 MCP Agent。