読み込み中

リソースへのアクセス

レッスン 569 分
読み込み中

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

リソースフローを理解する

オートコンプリートを埋めるために、MCPクライアントはMCPサーバーからdocs://documentsを読み取り、ドキュメント名をコードに返します。

ユーザーがリソースのコンテンツにアクセスしたい場合、フローは次のように動作します。

  • ユーザーがリソースに関する情報をリクエストする(「@report.pdf」のように)
  • コードはオートコンプリートのためにドキュメント名の一覧を必要とする
  • MCPクライアントがMCPサーバーにReadResourceRequestを送信する
  • サーバーはリソースデータを含むReadResourceResultで応答する
  • コードはこのデータをプロンプトに直接組み込むことができる

リソース読み取りの実装

MCPクライアントからリソースを読み取るには、read_resource関数を実装する必要があります。まず、必要なインポートを追加します。

python
import json
from pydantic import AnyUrl

コアとなる関数は、MCPセッションにリクエストを送信し、レスポンスを処理します。

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

異なるリソースタイプの処理

リソースはさまざまな種類のコンテンツを返すことができるため、MIMEタイプを確認し、それに応じて解析する必要があります。

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

このアプローチは、主に2つのシナリオを処理します。

  • パースが必要なJSONリソース
  • そのまま返せるプレーンテキストリソース

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

MCP InspectorのResourcesタブ: docs://documents/report.pdfを読み取ると、mimeType "text/plain" とレポートのテキストが返されます。

アプリケーション内でテストすることで、リソースの実装が正しく動作していることを確認できます。「@」の後にリソース名を入力すると、利用可能なリソースのオートコンプリート一覧が表示されるはずです。いずれかを選択すると、そのコンテンツがプロンプトに直接含まれます。

このアプローチの主な利点は効率性です。Claudeは、情報にアクセスするための追加のツール呼び出しを行う必要なく、すぐにドキュメントのコンテンツを受け取ります。

リソースとツールの使い分け

リソースは、特に次のような場合に有用です。

  • 頻繁に参照される静的またはセミ静的なコンテンツがある場合
  • API呼び出しの回数を減らしたい場合
  • コンテンツがプロンプトのコンテキスト内で即座に利用可能であるべき場合

これは、動的な操作に適している、あるいは会話のコンテキストに基づいて特定の情報にアクセスするかどうかをAIに判断させる必要がある場合に適しているツールとは異なります。