シラバス レッスン 250 中 139 · 構造化出力と関数/ツール呼び出し
構造化出力と関数/ツール呼び出し

MCP(Model Context Protocol)上のツール

アプリにツールが 2 つ以上になると、モデルの提供元ごとに呼び出しのための独自の JSON の形が発明され、提供元ごとにアダプターを書く羽目になります。Model Context Protocol(MCP)はこれを直すオープンな標準です。ツール(モデルが呼べる関数)、リソース(読めるデータ)、プロンプトを、どんなモデルのクライアントにも公開するための JSON-RPC 2.0 の通信プロトコルです。MCP サーバーを一度書けば、MCP を理解するどんなクライアント(IDE のアシスタント、デスクトップアプリ、エージェント)でもそれを使えます。

どのメッセージも JSON-RPC 2.0 で、それは小さな決まった封筒です。リクエストは必ず 4 つのキーを運びます:

{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
 "params": {"name": "add", "arguments": {"a": 2, "b": 3}}}

id は返答をそのリクエストに結び付けます。サーバーは同じ id をそのまま返し、result か error オブジェクトのどちらかを運ぶ(決して両方ではない)レスポンスで答えます:

{"jsonrpc": "2.0", "id": 1, "result": {"content": [{"type": "text", "text": "5"}], "isError": false}}
{"jsonrpc": "2.0", "id": 1, "error": {"code": -32601, "message": "Method not found"}}

負のコードは標準の JSON-RPC のものです:-32601 は「メソッドが見つからない」、-32602 は「無効なパラメーター」、などです。tools/call の結果は常にその形です:ブロック(テキスト、画像など)の content のリストと isError です。実行されたけれど失敗したツール(たとえば間違った都市名)は、モデルが失敗を読めるように、ふつうの結果の中で isError: true で答えます。JSON-RPC の error オブジェクトは、未知のメソッドのようなプロトコルの問題のためのものです。

セッションはハンドシェイクで始まります:クライアントが initialize のリクエスト(プロトコルのバージョン、自分の能力、名前)を送り、サーバーが自分の能力で答え、クライアントが notifications/initialized の通知(誰も返答しないので id のないメッセージ)で確認します。そのあとで初めて、クライアントは空のパラメーターで tools/list を呼んでツールを発見し、サーバーはツールの記述のリストを返します。

本物の MCP サーバーは stdio か HTTP の上で動き、これを SDK につなぎますが、ここでは通信の形式が具体的になるように、標準ライブラリの json モジュールでメッセージを作って解析します。関数を 3 つ書きます。

  • build_request(id, method, params) -> 封筒 {"jsonrpc": "2.0", "id": id, "method": method, "params": params} の JSON の文字列。json.dumps を使います。
  • parse_response(text) -> テキストを json.loads し、jsonrpc == "2.0" を求めます(そうでなければ ValueError を送出)。result があれば {"id": ..., "ok": True, "result": ...} を返します。error があれば {"id": ..., "ok": False, "error": {"code": ..., "message": ...}} を返します。どちらもなければ ValueError を送出します。
  • list_tools_request(id) -> ツールを発見するリクエスト:メソッド "tools/list" と空の params {} で作った build_request。

build_request は文字列を返すので、テストはそれを json.loads で解析し直して辞書を比べます。だからキーの順番は関係ありません。結果とエラーがどちらも往復でき、発見のリクエストが正しいメソッドを持ち、jsonrpc が欠けているか result も error も持たないメッセージはエラーになるようにしましょう。

あなたの番

json モジュールで MCP 風の JSON-RPC 2.0 のメッセージを作って解析してください。build_request(id, method, params) は {"jsonrpc": "2.0", "id", "method", "params"} の JSON の文字列を返します。parse_response(text) はテキストを読み込み、jsonrpc == "2.0" を求め(そうでなければ ValueError を送出)、結果なら {"id", "ok": True, "result"} を、エラーなら {"id", "ok": False, "error": {"code", "message"}} を返し、どちらもなければエラーを送出します。list_tools_request(id) は(ハンドシェイクのあとに送る)空のパラメーターの tools/list の発見のリクエストを返します。

このレッスンに問題を見つけましたか?報告する · このレッスンについて質問する

この演習はまもなく開きます

その前のレッスンを終えると、このレッスンが解放されます。コース全体が無料でアカウントも不要、このレッスンは今すぐ読めます。