読み込み中

リソースの定義

レッスン 555 分
読み込み中

MCPサーバーのリソースを使用すると、一般的なHTTPサーバーのGETリクエストハンドラーと同様に、クライアントにデータを公開できます。これらは、アクションを実行するのではなく、情報を取得する必要があるシナリオに最適です。

リソースを理解する

リソースは、文字列、JSON、バイナリファイルなど、あらゆる種類のデータを返すことができる読み取り専用のエンドポイントだと考えてください。'mime_type' を設定することで、返すデータの種類についてクライアントにヒントを与えます。

直接呼び出し可能な list_docs と、テンプレート化された fetch_doc という2つのリソースを保持するMCPサーバーの図。下のコードに示されています。

リソースは、クライアントがリクエストできるURI(URLのようなもの)を定義することで機能します。クライアントがデータを必要とするとき、特定のURIを含むReadResourceRequestを送信し、サーバーはデータを含むReadResourceResultで応答します。

2種類のリソース

作成できるリソースには主に2種類あります。

  • 直接リソース(Direct Resources) - パラメータを含まない静的なURIを持ちます(「docs://documents」など)
  • テンプレート化されたリソース(Templated Resources) - 解析されて関数に渡されるパラメータをURIに含みます(「docs://documents/{doc_id}」など)

URIパラメータを持たない直接リソースと、そのURIパラメータをPython SDKが関数に渡すテンプレート化されたリソースの比較。

テンプレート化されたリソースの場合、Python SDKはURIからパラメータを自動的に解析し、それらをキーワード引数として関数に渡します。URI内のパラメータ名は、関数のパラメータ名と正確に一致する必要があります。

リソースの作成

両方の種類のリソースを実装する方法は次のとおりです。

python
@mcp.resource(
    "docs://documents",
    mime_type="application/json"
)
def list_docs() -> list[str]:
    return list(docs.keys())

@mcp.resource(
    "docs://documents/{doc_id}",
    mime_type="text/plain"
)
def fetch_doc(doc_id: str) -> str:
    if doc_id not in docs:
        raise ValueError(f"Doc with id {doc_id} not found")
    return docs[doc_id]

MCP Python SDKは、返されたものを自動的にシリアライズします。データを手動でJSON文字列に変換する必要はありません。Pythonオブジェクトを返すだけで、SDKが変換を処理します。

リソースをテストする

MCP Inspectorを使用してリソースをテストできます。次のコマンドでサーバーを起動します。

uv run mcp dev mcp_server.py

次に、ブラウザでインスペクターに接続します。2つのセクションが表示されます。

  • Resources - 直接的(静的)なリソースの一覧を表示します
  • Resource Templates - テンプレート化されたリソースを表示します

MCP InspectorのResourcesタブ:docs://documents リソース、fetch_doc テンプレート、6つのドキュメントを一覧表示するJSONレスポンス。

任意のリソースをクリックしてテストします。テンプレート化されたリソースの場合は、パラメータの値を指定する必要があります。インスペクターには、mimeタイプやシリアライズされたデータを含め、クライアントが受け取る正確なレスポンス構造が表示されます。

実践的なユースケース

リソースは、チャットアプリケーションでのドキュメントメンションのような機能を実装するのに最適です。例えば、ユーザーが「@」と入力してドキュメントをメンションする場合、次のようにできます。

  1. 直接リソースを使用して、オートコンプリート用に利用可能なすべてのドキュメントの一覧を取得する
  2. テンプレート化されたリソースを使用して、メンションされた特定のドキュメントの内容を取得する

このアプローチにより、AIに情報を取得するためのツールを使用させることなく、ドキュメントの内容をプロンプトに事前に注入できます。