MCP 用 JSON-RPC 傳訊息:先取得工具定義,再轉送模型選定的操作

深讀 L2 761 字 2 分鐘 v2.0.0 更新 2026-11-16

MCP 是連接外部工具的開放標準,訊息以 JSON-RPC 表達。client 先用 tools/list 取得工具定義,再用 tools/call 轉送模型選定的操作。

JSON-RPC 訊息分為請求、回應與通知。讀懂一次往返,要看誰送出請求,以及哪一則回應對應這個請求。

先分清誰連線、誰提供工具

host 是使用者操作的程式,例如 Claude Code。client 是 host 裡負責連線的元件,server 則是提供工具的程式。

harness 是模型外圍、負責工具執行的程式。Claude Code 就是一個 harness。

server 能提供工具、可讀取的資源與提示範本,分別稱為 tools、resources 與 prompts。本文追的是 tools,模型負責決定何時使用。

host 替每個 server 各開一個 client。下圖示範這些元件的位置,以及各個 client 與 server 的連線關係。

host 就是 harness。host 決定哪些 server 可以連線。

取得清單後,才有模型能選的工具

client 先送出 tools/list 請求,詢問 server 有哪些工具。以下是一次 tools/list 往返。

{"jsonrpc": "2.0", "id": 1,
 "method": "tools/list"}

server 在回應的 result.tools 放入工具定義。名稱、說明與參數格式各自的用途,見 工具呼叫的格式。

{"jsonrpc": "2.0", "id": 1,
 "result": {"tools": [{
   "name": "get_weather",
   "description": "Get the weather.",
   "inputSchema": {"type": "object"}}]}}

harness 收到清單後,把 server 回傳的內容轉成模型的工具定義。

模型選操作,client 負責轉送

工具呼叫 是模型提出工具名稱與參數,再由 harness 執行並送回結果的過程。在 MCP 這一段,client 把模型選定的操作轉成 tools/call 請求,送到 server。

server 執行後回傳結果,回應沿用該次請求的 id。

要觀察這個過程,可以用 MCP Inspector 連上一個 server。先查看 tools/list 的請求與回應,再查看 tools/call 的請求與回應。

下圖依訊息發生的順序,示範 client 列出工具、server 回傳定義、client 送出操作,以及 server 回傳結果的往返。

1 / 4
  1. CLIENT{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}

client 先問 server 有哪些工具。

從訊息停在哪一步開始查

工具執行失敗時,server 回傳 isError 為 true 的結果,讓模型讀到。訊息格式錯誤則回傳 JSON-RPC 的 error,兩者要分開判讀。

本機訊息通道不能混入紀錄

使用 stdio,也就是標準輸入與輸出傳訊息時,host 會把 server 當成子程序啟動。訊息一行一則,host 寫進 server 的 stdin,再從 server 的 stdout 逐行讀回。

log 是程式執行時留下的紀錄。server 的 log 必須寫到 stderr,因為 stdout 只能出現 MCP 訊息。

來源

讀完之後

HarnessLLM迴圈工具context快取KV接手協定權限沙箱層注入子 agent實作評測