読み込み中

リソースへのアクセス

レッスン 5410 分

MCPにおけるリソースは、情報にアクセスするためにツール呼び出しを必要とするのではなく、プロンプトに直接含めることができるデータをサーバーが公開できるようにします。これにより、ClaudeのようなAIモデルにコンテキストを提供するより効率的な方法が実現します。

リソースリクエストを理解する

MCPサーバー上でリソースを定義したら、クライアントはそれらをリクエストして使用する方法を必要とします。クライアントはアプリケーションとMCPサーバーの間の橋渡しとして機能し、通信とデータ解析を自動的に処理します。

その流れは単純です。ユーザーがドキュメントを参照したい場合(「@report.pdf」と入力するなど)、アプリケーションはMCPクライアントを使用してサーバーからそのリソースを取得し、その内容をClaudeに送信されるプロンプトに直接含めます。

リソース読み取りの実装

中核となる機能には、MCPクライアント内にread_resource関数が必要です。この関数は、取得するリソースを識別するURIパラメータを受け取ります。

python
async def read_resource(self, uri: str) -> Any:
    result = await self.session().read_resource(AnyUrl(uri))
    resource = result.contents[0]

MCPサーバーからのレスポンスにはcontentsリストが含まれます。通常、必要なのは最初の要素のみで、これにはMIMEタイプなどのメタデータとともに実際のリソースデータが含まれています。

異なるコンテンツタイプの処理

リソースは異なるタイプのコンテンツを返すことができるため、クライアントはそれらを適切に解析する必要があります。MIMEタイプは、データをどのように処理すべきかを示すヒントとなります。

python
if isinstance(resource, types.TextResourceContents):
    if resource.mimeType == "application/json":
        return json.loads(resource.text)
    
    return resource.text

このアプローチにより、JSONリソースはPythonオブジェクトに適切に解析され、プレーンテキストのリソースは文字列として返されることが保証されます。MIMEタイプは、正しい解析戦略を決定するためのヒントとして機能します。

必要なインポート

これを正しく機能させるには、MCPクライアントに以下のインポートが必要です。

python
import json
from pydantic import AnyUrl

jsonモジュールはJSONレスポンスの解析を処理し、AnyUrlはURIパラメータの適切な型処理を保証します。

リソースアクセスのテスト

実装が完了したら、CLIアプリケーションを通じて機能をテストできます。「What's in the @report.pdf document?」のように入力すると、システムは以下を行うはずです。

  • 利用可能なリソースを自動補完リストに表示する
  • リソースを選択できるようにする
  • リソースの内容を自動的に取得する
  • その内容をClaudeへのプロンプトに含める

主な利点は、Claudeがドキュメントの内容をプロンプト内で直接受け取ることができ、情報にアクセスするためのツール呼び出しが不要になることです。これにより、インタラクションがより高速かつ効率的になります。

アプリケーションとの統合

作成したMCPクライアントのコードは、アプリケーションの他の部分で使用されることを覚えておいてください。read_resource関数は、他のコンポーネントがドキュメントの内容を取得したり、利用可能なリソースを一覧表示したり、リソースデータをプロンプトに統合したりするために呼び出せる構成要素となります。

この関心の分離により、コードはクリーンに保たれます。MCPクライアントはサーバーとの通信を処理し、アプリケーションロジックはそのデータを効果的に使用する方法に焦点を当てます。