MCPサーバーのリソースは、一般的なHTTPサーバーにおけるGETリクエストハンドラーと同様に、クライアントにデータを公開できるようにします。アクションを実行するのではなく、情報を取得する必要があるシナリオに最適です。
例を通してリソースを理解する
ユーザーが @document_name と入力してファイルを参照できるドキュメントメンション機能を構築したいとします。これには次の2つの操作が必要です。
- 利用可能なすべてのドキュメントのリストを取得する(オートコンプリート用)
- 特定のドキュメントの内容を取得する(メンションされたとき)

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

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

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

- 直接リソース:
docs://documentsのような、変化しない静的なURI - テンプレート化リソース:
docs://documents/{doc_id}のような、パラメータを持つURI
テンプレート化リソースの場合、Python SDKは自動的にURIからパラメータを解析し、関数へのキーワード引数として渡します。
リソースの実装
リソースは @mcp.resource() デコレーターを使用して定義されます。両方の種類を作成する方法は次のとおりです。
直接リソース(ドキュメントの一覧取得)
@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]MIMEタイプ
リソースは文字列、JSON、バイナリなど、あらゆる種類のデータを返すことができます。mime_type パラメータは、返すデータの種類についてのヒントをクライアントに提供します。
application/json- 構造化されたJSONデータtext/plain- プレーンテキストのコンテンツ- その他のデータ形式に応じた任意の有効なMIMEタイプ
MCP Python SDKは、戻り値を自動的にシリアライズします。手動でJSON文字列に変換する必要はありません。
リソースのテスト
MCP Inspectorを使用してリソースをテストできます。次のコマンドでサーバーを実行してください。
uv run mcp dev mcp_server.py次に、ブラウザでInspectorに接続します。次のような画面が表示されます。

- Resources: 直接/静的リソースを一覧表示します
- Resource Templates: パラメータを受け取るテンプレート化リソースを表示します
任意のリソースをクリックしてテストし、クライアントが受け取る正確なレスポンス構造を確認できます。

重要なポイント
- リソースはデータを公開し、ツールはアクションを実行します
- 静的データには直接リソースを、パラメータ化されたクエリにはテンプレート化リソースを使用します
- MIMEタイプはクライアントがレスポンス形式を理解するのに役立ちます
- SDKはシリアライズを自動的に処理します
- テンプレート化URI内のパラメータ名は関数の引数になります
リソースは、ドキュメントメンション、ファイルブラウジング、またはサーバーから情報を取得する必要があるあらゆるシナリオなど、MCPクライアントにデータを利用可能にするためのクリーンな方法を提供します。