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

MCPクライアントは主に2つのコンポーネントで構成されています。
- MCP Client - セッションを使いやすくするために私たちが作成するカスタムクラス
- Client Session - サーバーへの実際の接続(MCP Python SDKの一部)

クライアントセッションは、使い終わったときに適切なリソースのクリーンアップが必要です。そのため、そのクリーンアップ処理をすべて自動で行うために、カスタムのMCP Clientクラスでそれをラップしているのです。
クライアントがアプリケーションにどう組み込まれるか
私たちのアプリケーションのフローを思い出してください。私たちのCLIコードは、MCPサーバーに対して主に2つのことを行う必要があります。

- Claudeに送信する利用可能なツールの一覧を取得する
- Claudeがツールを要求したときにそれを実行する
MCPクライアントは、これらの機能をシンプルなメソッド呼び出しを通じて提供し、私たちのアプリケーションコードから利用できるようにします。
コアメソッドの実装
クライアントにはlist_tools()とcall_tool()という2つの重要なメソッドを実装する必要があります。
List Tools メソッド
このメソッドは、サーバーから利用可能なすべてのツールを取得します。
async def list_tools(self) -> list[types.Tool]:
result = await self.session().list_tools()
return result.toolsとてもシンプルです。私たちはセッション(サーバーへの接続)にアクセスし、組み込みのlist_tools()関数を呼び出し、結果からツールを返します。
Call 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)ツール名と(Claudeから提供された)入力パラメータをサーバーに渡し、結果を返します。
クライアントのテスト
実装をテストするために、クライアントを直接実行することができます。ファイルの末尾には簡単なテスト用のハーネスが用意されています。新しく作成したメソッドの1つを呼び出させて、その結果を表示させてみましょう。
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にドキュメントについて質問すると、次のようになります。
- 私たちのコードはクライアントを使って利用可能なツールを取得します
- これらのツールは、ユーザーの質問とともにClaudeに送信されます
- Claudeは
read_doc_contentsツールを使うことを決定します - 私たちのコードはクライアントを使ってそのツールを実行します
- 結果はClaudeに送り返され、Claudeがユーザーに応答します
例えば、「report.pdfドキュメントの内容は何ですか?」と尋ねると、Claudeは私たちが作成したドキュメント読み取りツールを使用し、サーバーで設定した20mコンデンサータワーのドキュメントに関する情報が返ってきます。
クライアントは、私たちのアプリケーションロジックとMCPサーバーの間の橋渡し役として機能し、基盤となる接続の詳細を気にすることなく、サーバーの機能に簡単にアクセスできるようにします。