読み込み中

クライアントの実装

レッスン 5310 分
読み込み中

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

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

コードに入る前に、MCPプロジェクトに関する重要な点を明確にしておきましょう。通常、MCPクライアントとMCPサーバーのどちらか一方を実装するものであり、両方を実装することはありません。このプロジェクトでは、両方がどのように連携して動作するかを見てもらうために、あえて両方を構築しています。

MCPクライアントを含む当社サーバーの図。両方向に接続された別のMCPサーバーに接続している様子。

MCPクライアントは、連携して動作する2つの主要なコンポーネントで構成されています。

mcp_client.pyの図。MCPクライアントとクライアントセッションを含み、別のMCPサーバーに接続している様子。

  • MCPクライアント - セッションの利用を簡単にするために作成するカスタムクラス
  • クライアントセッション - サーバーへの実際の接続(MCP Python SDKの一部)

クライアントセッションは低レベルの通信を処理しますが、プログラムを終了する際には慎重なリソースのクリーンアップが必要です。そのため、そのクリーンアップを自動的に管理できるよう、独自のクラスでラップしているのです。

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

アプリケーションのフロー図を覚えていますか?クライアントは2つの重要な場面で決定的な役割を果たします。

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

CLIコードはクライアントを使用して以下を行います。

  • Claudeに送信する利用可能なツールの一覧を取得する
  • Claudeがリクエストした際にツールを実行する

コアクライアント関数の実装

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

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)

これだけです!複雑な通信の詳細はすべてセッションが処理してくれます。

クライアントのテスト

クライアントファイルの末尾には、簡単なテストハーネスが含まれています。直接実行して、すべてが正しく動作するか確認できます。

bash
uv run mcp_client.py

これにより、MCPサーバーに接続し、利用可能なツールが出力されます。ツール定義を示す出力が表示されるはずです。これには、名前、説明、入力スキーマが含まれます。

重要なスキーマの違い

ここで知っておくべき注意点があります。MCPツール定義は、Claudeが期待するものと正確には一致しません。MCP仕様にはツールスキーマ用の独自の形式があり、それはBedrockが要求するものとは少し異なります。

心配はいりません - この変換を自動的に処理するコードはすでにプロジェクト内にあります。core/bedrock.py内のto_bedrock_tools関数が、MCPツール定義をClaudeが理解できる形式に変換します。

Claudeでのテスト

サーバーとクライアントの両方が動作するようになったので、完全なフローをテストできます。メインアプリケーションを実行し、Claudeにドキュメントを読むよう依頼してみましょう。

bash
uv run main.py

その後、「report.pdfドキュメントの内容は何ですか?」と尋ねてください。

Claudeは次のことを行います。

  1. クライアントから利用可能なツールの一覧を受け取る
  2. read_doc_contentsツールを使用することを決定する
  3. クライアントがMCPサーバー上でそのツールを実行する
  4. Claudeがドキュメントの内容を受け取り、応答する

クライアントは、アプリケーションコードとMCPサーバーとの間の橋渡し役を担い、サーバーの機能をClaudeやシステムの他の部分に簡単に公開できるようにします。