読み込み中

MCPクライアント

レッスン 502 分
読み込み中

MCPクライアントは、サーバーとMCPサーバーの間の通信の橋渡し役を担います。MCPサーバーが提供するすべてのツールへのアクセスポイントだと考えてください。外部の機能を利用する必要があるとき、クライアントはメッセージのやり取りとプロトコルの詳細をすべて代わりに処理してくれます。

トランスポート非依存の通信

MCPの主な強みの1つは、トランスポート非依存であることです。つまり、クライアントとサーバーが異なる通信方式を使ってやり取りできるということです。最も一般的な構成では、MCPクライアントとサーバーの両方を同じマシン上で動作させ、標準入出力を介して通信します。

当社のサーバーはMCPクライアントを保持しており、ローカルで動作するGitHubのMCPサーバーと標準入出力を介して双方向にやり取りします。

しかし、この方法に限定されているわけではありません。MCPクライアントとサーバーは、以下の方法でも接続できます。

  • HTTP
  • WebSocket
  • その他各種のネットワークプロトコル

当社のサーバーにはMCPクライアントが含まれており、GitHub用のMCPサーバーとWebSocket経由で双方向にやり取りします。

メッセージの種類

接続が確立されると、クライアントとサーバーはMCP仕様で定義された特定の種類のメッセージをやり取りします。主に扱うのは次のものです。

当社のサーバー内のMCPクライアントがGitHubのMCPサーバーにListToolsRequestを送信し、サーバーはListToolsResultで応答します。

ListToolsRequest/ListToolsResult: クライアントはサーバーに「どのようなツールを提供していますか?」と尋ね、利用可能な機能の完全な一覧を受け取ります。

当社のサーバー内のMCPクライアントがGitHubのMCPサーバーにListToolsRequestを送信し、サーバーはListToolsResultで応答します。

CallToolRequest/CallToolResult: クライアントはサーバーに「これらの引数でこの特定のツールを実行してください」と伝え、実行結果を受け取ります。

当社のサーバーはMCPクライアントを保持しており、GitHub用のMCPサーバーにCallToolRequestを送信し、CallToolResultを受け取ります。

実際の例の流れ

これらすべての要素がどのように連携するのかを理解するために、完全な例を見ていきましょう。ユーザーが「私にはどのリポジトリがありますか?」と尋ねた場合を想像してください。これが通信チェーン全体です。

ユーザー、当社のサーバー、MCPクライアント、MCPサーバー、GitHub、Claudeのシーケンス図のライフラインで、まだメッセージが送られていない状態。

このプロセスは、ユーザーが質問をサーバーに送信した時点から始まります。サーバーは、AIへのリクエストを行う前に、Claudeに利用可能なツールを提供する必要があると判断します。

シーケンス図:ユーザー、当社のサーバー、MCPクライアント、MCPサーバー、GitHub、Claude。ユーザーの質問の矢印が当社のサーバーに向かっています。

サーバーはMCPクライアントにツール一覧を要求し、これによりMCPサーバーへのListToolsRequestがトリガーされます。サーバーは、利用可能なすべてのツールを含むListToolsResultで応答します。

シーケンス図:当社のサーバーはMCPクライアントにClaude用のツールが必要だと伝え、その後ListToolsRequestとListToolsResultが続きます。

これで、サーバーは最初のClaudeへのリクエストを行うために必要なすべてを手に入れました。つまり、ユーザーの質問と利用可能なツールです。Claudeはツールを分析し、質問に正しく答えるためにいずれかを呼び出す必要があると判断します。

ツール一覧のやり取りのシーケンス図に、当社のサーバーからClaudeへの「クエリ+ツール」という矢印のラベルが追加されています。

Claudeはツール使用リクエストで応答します。サーバーはこれを認識し、MCPクライアントにClaudeが指定した引数でツールを実行するよう依頼します。

シーケンス図:ツール一覧のやり取りの後、当社のサーバーがClaudeに「クエリ+ツール」を送信し、Claudeは「ツール使用」で応答します。

MCPクライアントはMCPサーバーにCallToolRequestを送信し、MCPサーバーはGitHubに実際のAPI呼び出しを行い、ユーザーのリポジトリを取得します。

MCPクライアントからMCPサーバーへのCallToolRequestを経て、MCPサーバーからGitHubへのリクエストに至る流れのシーケンス図。

GitHubはリポジトリのデータを返し、MCPサーバーはそれをCallToolResultにラップしてチェーンを通じて送り返します。サーバーはこのデータを受け取り、Claudeへフォローアップのリクエストを行えるようになります。

ユーザー、当社のサーバー、MCPクライアント、MCPサーバー、Claude、GitHubの間のメッセージのシーケンス図。ツール結果までの流れ。

最後のステップでは、ツールの結果をユーザーメッセージの一部としてClaudeに送信します。これでClaudeは、ユーザーのリポジトリに関する完全な応答を組み立てるために必要なすべての情報を手にしています。

ユーザー、当社のサーバー、MCPクライアント、MCPサーバー、Claude、GitHubの間の、これまで説明してきた全体の流れのシーケンス図。

確かに、この流れには多くのステップがありますが、これを理解しておくことで、独自のMCPクライアントとサーバーを実装する際の備えになります。各コンポーネントには固有の役割があり、標準化されたメッセージの種類によって、下層のトランスポート機構に関係なく、すべてが円滑に連携することが保証されています。