MCPサーバーが動作するようになったので、今度はクライアント側を構築する番です。クライアントは、アプリケーションがMCPサーバーと通信し、その機能にアクセスできるようにするものです。
クライアントアーキテクチャを理解する
コードに入る前に、MCPプロジェクトに関する重要な点を明確にしておきましょう。通常、MCPクライアントとMCPサーバーのどちらか一方を実装するものであり、両方を実装することはありません。このプロジェクトでは、両方がどのように連携して動作するかを見てもらうために、あえて両方を構築しています。

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

- MCPクライアント - セッションの利用を簡単にするために作成するカスタムクラス
- クライアントセッション - サーバーへの実際の接続(MCP Python SDKの一部)
クライアントセッションは低レベルの通信を処理しますが、プログラムを終了する際には慎重なリソースのクリーンアップが必要です。そのため、そのクリーンアップを自動的に管理できるよう、独自のクラスでラップしているのです。
クライアントがアプリケーションにどのように組み込まれるか
アプリケーションのフロー図を覚えていますか?クライアントは2つの重要な場面で決定的な役割を果たします。

CLIコードはクライアントを使用して以下を行います。
- Claudeに送信する利用可能なツールの一覧を取得する
- Claudeがリクエストした際にツールを実行する
コアクライアント関数の実装
list_toolsとcall_toolという2つの重要な関数を実装しましょう。
list_toolsでは、セッションに接続して利用可能なツールをリクエストする必要があります。
async def list_tools(self) -> list[types.Tool]:
result = await self.session().list_tools()
return result.toolscall_toolでは、ツール名と入力パラメータをサーバーに渡します。
async def call_tool(
self, tool_name: str, tool_input: dict
) -> types.CallToolResult | None:
return await self.session().call_tool(tool_name, tool_input)これだけです!複雑な通信の詳細はすべてセッションが処理してくれます。
クライアントのテスト
クライアントファイルの末尾には、簡単なテストハーネスが含まれています。直接実行して、すべてが正しく動作するか確認できます。
uv run mcp_client.pyこれにより、MCPサーバーに接続し、利用可能なツールが出力されます。ツール定義を示す出力が表示されるはずです。これには、名前、説明、入力スキーマが含まれます。
重要なスキーマの違い
ここで知っておくべき注意点があります。MCPツール定義は、Claudeが期待するものと正確には一致しません。MCP仕様にはツールスキーマ用の独自の形式があり、それはBedrockが要求するものとは少し異なります。
心配はいりません - この変換を自動的に処理するコードはすでにプロジェクト内にあります。core/bedrock.py内のto_bedrock_tools関数が、MCPツール定義をClaudeが理解できる形式に変換します。
Claudeでのテスト
サーバーとクライアントの両方が動作するようになったので、完全なフローをテストできます。メインアプリケーションを実行し、Claudeにドキュメントを読むよう依頼してみましょう。
uv run main.pyその後、「report.pdfドキュメントの内容は何ですか?」と尋ねてください。
Claudeは次のことを行います。
- クライアントから利用可能なツールの一覧を受け取る
- read_doc_contentsツールを使用することを決定する
- クライアントがMCPサーバー上でそのツールを実行する
- Claudeがドキュメントの内容を受け取り、応答する
クライアントは、アプリケーションコードとMCPサーバーとの間の橋渡し役を担い、サーバーの機能をClaudeやシステムの他の部分に簡単に公開できるようにします。