読み込み中
読み込み中

MCPサーバーにおけるリソースは、典型的なHTTPサーバーにおけるGETリクエストハンドラーと同様に、クライアントにデータを公開できるようにするものです。アクションを実行するのではなく、情報を取得する必要があるシナリオに最適です。

リソースを理解する

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

direct な list_docs と、テンプレート化された fetch_doc という2つのリソースを保持するMCPサーバーの図。以下のコードで示されています。

リソースは、URI(本質的にはアドレス)を通じてデータを公開することで機能します。クライアントがデータを必要とするとき、特定のURIを含むReadResourceRequestを送信し、サーバーは要求された情報で応答します。

2種類のリソース

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

  • Direct Resource(直接リソース) - パラメータを含まない静的なURIを持つもの(docs://documents など)
  • Templated Resource(テンプレート化リソース) - URIにパラメータを含むもの(docs://documents/{doc_id} など)

URIパラメータを持たないDirect Resourceと、Python SDKがURIパラメータを関数に渡すTemplated Resourceとの比較。

テンプレート化リソースの場合、Python SDKはURIからパラメータを自動的にパースし、それらをキーワード引数として関数に渡します。URI内のパラメータ名が、関数内の引数名になります。

リソースの実装

リソースの作成は、@mcp.resource() デコレータを使用すれば簡単です。両方の種類を実装する方法は次のとおりです。

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のデータ構造をそのまま返すだけで構いません。

リソースのテスト

MCP Inspectorツールを使ってリソースをテストできます。uv run mcp dev mcp_server.py でサーバーを起動し、Webインターフェースにアクセスしてください。

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

InspectorはDirect Resourceとテンプレート化リソースを分けて表示します。Direct Resourceはメインの「Resources」セクションに表示され、テンプレート化リソースは「Resource Templates」の下に表示されます。任意のリソースをクリックしてテストし、サーバーが返す正確なレスポンス構造を確認できます。

実用的なユースケース

リソースは以下のような用途に最適です。

  • オートコンプリート用データの提供(ドキュメント一覧など)
  • ファイルの内容やデータベースレコードの取得
  • 設定データの公開
  • クライアントが必要とするあらゆる読み取り専用情報の提供

リソースの主な利点は、クライアントがツールや複雑なやり取りに頼ることなく、プロアクティブにデータを取得できることです。これにより、ドキュメントへの言及など、ユーザーの参照に基づいてプロンプトにコンテンツを自動的に挿入するような機能に最適です。