読み込み中
読み込み中

MCPクライアントは、あなたのサーバーとMCPサーバーの間の通信の橋渡し役として機能します。MCPサーバーが提供するすべてのツールへのアクセスポイントだと考えてください。外部機能を使用する必要がある場合、クライアントがメッセージの受け渡しとプロトコルの詳細をすべて処理してくれます。

トランスポートに依存しない通信

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

私たちのサーバーはMCPクライアントを保持しており、ローカルで実行されているGitHub MCPサーバーと標準入出力を介して双方向にやり取りしています。

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

  • HTTP
  • WebSockets
  • その他のさまざまなネットワークプロトコル

私たちのサーバーはMCPクライアントを含んでおり、WebSocketsを介してGitHub用のMCPサーバーと双方向にやり取りしています。

メッセージタイプ

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

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

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

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

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

完全なフロー例

ここでは、実際のシナリオですべての要素がどのように連携して動作するかを説明します。ユーザーが「自分が持っているリポジトリは何ですか?」と尋ねたとします。以下が完全な通信フローです。

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

プロセスは、ユーザーが質問をあなたのサーバーに送信することから始まります。しかし、あなたのサーバーがClaudeに助けを求める前に、どんなツールが利用可能かを知る必要があります。

シーケンス図:私たちのサーバーがMCPクライアントにClaude用のツールが必要だと伝え、続いてListToolsRequestとListToolsResultが発生します。

あなたのサーバーはMCPクライアントにツールのリストを要求します。クライアントはMCPサーバーにListToolsRequestを送信し、利用可能なすべてのツールを含むListToolsResultを受け取ります。

ツールリストのやり取りのシーケンス図。今回は私たちのサーバーからClaudeへ「Query + Tools」というラベルの矢印が追加されています。

これで、あなたのサーバーはClaudeへの最初のリクエストを行うために必要なすべて、すなわちユーザーの質問と利用可能なツールのリストを揃えました。

シーケンス図:ツールリストのやり取りの後、私たちのサーバーがClaudeに「Query + Tools」を送信し、Claudeが「ToolUse」で応答します。

Claudeはツールを分析し、質問に答えるためにツールを呼び出す必要があると判断します。Claudeはツール使用リクエストで応答します。

これまでのフローのシーケンス図。今回は私たちのサーバーがMCPクライアントに「このツールをこれらの引数で実行してください」と伝える部分が追加されています。

あなたのサーバーは、Claudeがツールを実行したがっていることを認識しますが、あなたのサーバーはもはやツールを直接実行しません。それはMCPサーバーの役目です。そこで、Claudeが指定した引数でツールを実行するようMCPクライアントに依頼します。

MCPクライアントからMCPサーバーへのCallToolRequestを経由し、続いてGitHubへのリクエストに至るまでのフローのシーケンス図。

MCPクライアントはMCPサーバーにCallToolRequestを送信し、MCPサーバーはユーザーのリポジトリを取得するためにGitHubへ実際のリクエストを行います。

ユーザー、私たちのサーバー、MCPクライアント、MCPサーバー、Claude、GitHubの間のメッセージのシーケンス図。ツール結果までの流れを示しています。

GitHubはリポジトリデータで応答し、MCPサーバーはそれをCallToolResultでラップしてMCPクライアントに送り返します。

ユーザーからGitHubまでの完全なフローのシーケンス図。今回は私たちのサーバーからClaudeへのtoolResultメッセージが追加されています。

MCPクライアントはツール結果をあなたのサーバーに返し、サーバーはそれをフォローアップメッセージの一部としてClaudeに送信します。

ユーザー、私たちのサーバー、MCPクライアント、MCPサーバー、Claude、GitHubの間の全体のフローのシーケンス図(前述の通り)。

最終的に、Claudeは必要な情報をすべて揃え、「あなたのリポジトリは…」といった応答を作成し、それはあなたのサーバーを経由してユーザーに送り返されます。

ユーザー、私たちのサーバー、MCPクライアント、MCPサーバー、Claude、GitHubの間の全体のフローのシーケンス図(前述の通り)。

確かに、このフローには多くのステップが含まれていますが、各コンポーネントには明確な責任があります。MCPクライアントはサーバー通信の複雑さを抽象化し、強力な外部ツールやサービスへのアクセスを維持しながら、あなたがアプリケーションロジックの構築に専念できるようにしてくれます。