読み込み中
読み込み中

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

例を通してリソースを理解する

ユーザーが @document_name と入力してファイルを参照できるドキュメントメンション機能を構築したいとします。これには次の2つの操作が必要です。

  • 利用可能なすべてのドキュメントのリストを取得する(オートコンプリート用)
  • 特定のドキュメントの内容を取得する(メンションされたとき)

チャットプロンプトで「@」を入力すると、deposition.mdやspec.mdなど、それぞれ「Resource」とラベル付けされたドキュメントのリストが表示されます。

ユーザーが @ と入力すると、利用可能なドキュメントを表示する必要があります。メンション付きでメッセージを送信すると、そのドキュメントの内容がClaudeに送信されるプロンプトに自動的に挿入されます。

アットマークを入力するとdesign.mdなど、それぞれ「Resource」とラベル付けされたドキュメントのリストが表示され、メンションするとreport.pdfの内容が挿入されます。

リソースの仕組み

リソースはリクエスト・レスポンスのパターンに従います。クライアントがURIを添えて ReadResourceRequest を送信し、MCPサーバーがそのデータを返します。URIはアクセスしたいリソースのアドレスのように機能します。

list_docsとfetch_docという2つのリソース定義を含む1つのMCPサーバーの図。以下のコードに示されています。

リソースの種類

リソースには2つの種類があります。

URIにパラメータを持たない直接リソースと、doc_idを持つテンプレート化リソースのデコレーターコード。以下で説明します。

  • 直接リソース: docs://documents のような、変化しない静的なURI
  • テンプレート化リソース: docs://documents/{doc_id} のような、パラメータを持つURI

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

リソースの実装

リソースは @mcp.resource() デコレーターを使用して定義されます。両方の種類を作成する方法は次のとおりです。

直接リソース(ドキュメントの一覧取得)

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

テンプレート化リソース(ドキュメントの取得)

python
@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]

MIMEタイプ

リソースは文字列、JSON、バイナリなど、あらゆる種類のデータを返すことができます。mime_type パラメータは、返すデータの種類についてのヒントをクライアントに提供します。

  • application/json - 構造化されたJSONデータ
  • text/plain - プレーンテキストのコンテンツ
  • その他のデータ形式に応じた任意の有効なMIMEタイプ

MCP Python SDKは、戻り値を自動的にシリアライズします。手動でJSON文字列に変換する必要はありません。

リソースのテスト

MCP Inspectorを使用してリソースをテストできます。次のコマンドでサーバーを実行してください。

bash
uv run mcp dev mcp_server.py

次に、ブラウザでInspectorに接続します。次のような画面が表示されます。

MCP InspectorのResourcesタブ。Resourcesの下にdocs://documentsがリストされ、Resource Templatesの下には何もリストされていません。

  • Resources: 直接/静的リソースを一覧表示します
  • Resource Templates: パラメータを受け取るテンプレート化リソースを表示します

任意のリソースをクリックしてテストし、クライアントが受け取る正確なレスポンス構造を確認できます。

MCP InspectorのResourcesタブ:docs://documentsを読み取ると、deposition.mdやplan.mdなどのファイル名のJSONリストが返されます。

重要なポイント

  • リソースはデータを公開し、ツールはアクションを実行します
  • 静的データには直接リソースを、パラメータ化されたクエリにはテンプレート化リソースを使用します
  • MIMEタイプはクライアントがレスポンス形式を理解するのに役立ちます
  • SDKはシリアライズを自動的に処理します
  • テンプレート化URI内のパラメータ名は関数の引数になります

リソースは、ドキュメントメンション、ファイルブラウジング、またはサーバーから情報を取得する必要があるあらゆるシナリオなど、MCPクライアントにデータを利用可能にするためのクリーンな方法を提供します。