読み込み中

クライアントの実装

レッスン 5210 分
読み込み中

MCPサーバーが動作するようになったので、今度はクライアント側を構築する番です。クライアントとは、私たちのアプリケーションがMCPサーバーと通信し、その機能にアクセスできるようにするものです。

クライアントアーキテクチャを理解する

実際のプロジェクトのほとんどでは、MCPクライアントかMCPサーバーのどちらか一方のみを実装します。両方を実装することはありません。このプロジェクトでは、両者がどのように連携して動作するかを見てもらうために、あえて両方を構築しています。

私たちのサーバーにはMCPクライアントが含まれており、これは別のMCPサーバーと双方向で通信します。

MCPクライアントは主に2つのコンポーネントで構成されています。

  • MCP Client - セッションを使いやすくするために私たちが作成するカスタムクラス
  • Client Session - サーバーへの実際の接続(MCP Python SDKの一部)

mcp_client.pyでは、MCP ClientがClient Sessionに接続し、Client Sessionが別のMCPサーバーに接続します。

クライアントセッションは、使い終わったときに適切なリソースのクリーンアップが必要です。そのため、そのクリーンアップ処理をすべて自動で行うために、カスタムのMCP Clientクラスでそれをラップしているのです。

クライアントがアプリケーションにどう組み込まれるか

私たちのアプリケーションのフローを思い出してください。私たちのCLIコードは、MCPサーバーに対して主に2つのことを行う必要があります。

以下の2つのステップのシーケンス図:MCPクライアントがListToolsRequestを送信し、次にCallToolRequestを送信して、それぞれの結果を受け取る。

  1. Claudeに送信する利用可能なツールの一覧を取得する
  2. Claudeがツールを要求したときにそれを実行する

MCPクライアントは、これらの機能をシンプルなメソッド呼び出しを通じて提供し、私たちのアプリケーションコードから利用できるようにします。

コアメソッドの実装

クライアントにはlist_tools()とcall_tool()という2つの重要なメソッドを実装する必要があります。

List Tools メソッド

このメソッドは、サーバーから利用可能なすべてのツールを取得します。

python
async def list_tools(self) -> list[types.Tool]:
    result = await self.session().list_tools()
    return result.tools

とてもシンプルです。私たちはセッション(サーバーへの接続)にアクセスし、組み込みのlist_tools()関数を呼び出し、結果からツールを返します。

Call Tool メソッド

このメソッドは、サーバー上で特定のツールを実行します。

python
async def call_tool(
    self, tool_name: str, tool_input: dict
) -> types.CallToolResult | None:
    return await self.session().call_tool(tool_name, tool_input)

ツール名と(Claudeから提供された)入力パラメータをサーバーに渡し、結果を返します。

クライアントのテスト

実装をテストするために、クライアントを直接実行することができます。ファイルの末尾には簡単なテスト用のハーネスが用意されています。新しく作成したメソッドの1つを呼び出させて、その結果を表示させてみましょう。

python
async with MCPClient(
    command="uv", args=["run", "mcp_server.py"]
) as client:
    result = await client.list_tools()
    print(result)

このテストを実行すると、以前作成したread_doc_contentsやedit_documentツールを含む、ツールの定義が出力されるはずです。

すべてをまとめる

これでクライアントはツールの一覧を取得し、それらを呼び出せるようになったので、一連の流れ全体をテストできます。メインのアプリケーションを実行してClaudeにドキュメントについて質問すると、次のようになります。

  1. 私たちのコードはクライアントを使って利用可能なツールを取得します
  2. これらのツールは、ユーザーの質問とともにClaudeに送信されます
  3. Claudeはread_doc_contentsツールを使うことを決定します
  4. 私たちのコードはクライアントを使ってそのツールを実行します
  5. 結果はClaudeに送り返され、Claudeがユーザーに応答します

例えば、「report.pdfドキュメントの内容は何ですか?」と尋ねると、Claudeは私たちが作成したドキュメント読み取りツールを使用し、サーバーで設定した20mコンデンサータワーのドキュメントに関する情報が返ってきます。

クライアントは、私たちのアプリケーションロジックとMCPサーバーの間の橋渡し役として機能し、基盤となる接続の詳細を気にすることなく、サーバーの機能に簡単にアクセスできるようにします。