読み込み中

クライアントを実装する

レッスン 547 分

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

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

コードに取り掛かる前に、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サーバーに接続しています。

クライアントセッションは使用後にリソースのクリーンアップが必要であり、これがカスタムクラスでラップする理由です。これにより、接続管理とクリーンアップが自動的に処理されます。

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

アプリケーションのフローを思い出してください。CLIコードは、Claudeと2つの主要な方法でやり取りする必要があります。

アプリケーションフローのシーケンス図。CLIコードがクライアントを使ってツールを一覧表示し、ツールを呼び出す箇所を強調表示しています。

クライアントは、サーバーの機能をコードベースに公開することで、これら両方のやり取りを可能にします。

コアとなるクライアント関数を実装する

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

非常にシンプルです。セッション(MCPサーバーへの接続)にアクセスし、組み込みの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によって提供される)をサーバーに渡し、その結果を返します。

クライアントをテストする

実装が正しく動作することを確認するために、直接テストできます。クライアントファイルには、MCPサーバーに接続してコマンドを実行するテストハーネスが含まれています。list_tools()を呼び出して、その結果を表示させてみましょう。

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

uv run mcp_client.pyを実行すると、利用可能なツールの一覧とその説明、入力スキーマが返されるはずです。サーバーで定義したread_doc_contentsやedit_documentなどのツールが表示されるはずです。

エンドツーエンドテスト

クライアントとサーバーの両方が動作するようになったので、完全なフローをテストできます。メインアプリケーションを実行し、Claudeに「report.pdfドキュメントの内容は何ですか?」と尋ねると、以下のようになるはずです。

  1. 利用可能なツールの一覧がClaudeに送信される
  2. Claudeがread_doc_contentsツールを使用することを決定する
  3. クライアントがサーバー上でツールを呼び出す
  4. サーバーがドキュメントの内容を返す
  5. Claudeがその情報をもとに応答する

クライアントは、アプリケーションコードとMCPサーバーとの間の橋渡し役として機能し、低レベルの接続の詳細を直接扱うことなく、サーバーの機能に簡単にアクセスできるようにします。