MCPサーバーのリソースを使用すると、一般的なHTTPサーバーのGETリクエストハンドラーと同様に、クライアントにデータを公開できます。これらは、アクションを実行するのではなく、情報を取得する必要があるシナリオに最適です。
リソースを理解する
リソースは、文字列、JSON、バイナリファイルなど、あらゆる種類のデータを返すことができる読み取り専用のエンドポイントだと考えてください。'mime_type' を設定することで、返すデータの種類についてクライアントにヒントを与えます。

リソースは、クライアントがリクエストできるURI(URLのようなもの)を定義することで機能します。クライアントがデータを必要とするとき、特定のURIを含むReadResourceRequestを送信し、サーバーはデータを含むReadResourceResultで応答します。
2種類のリソース
作成できるリソースには主に2種類あります。
- 直接リソース(Direct Resources) - パラメータを含まない静的なURIを持ちます(「docs://documents」など)
- テンプレート化されたリソース(Templated Resources) - 解析されて関数に渡されるパラメータをURIに含みます(「docs://documents/{doc_id}」など)

テンプレート化されたリソースの場合、Python SDKはURIからパラメータを自動的に解析し、それらをキーワード引数として関数に渡します。URI内のパラメータ名は、関数のパラメータ名と正確に一致する必要があります。
リソースの作成
両方の種類のリソースを実装する方法は次のとおりです。
@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 - テンプレート化されたリソースを表示します

任意のリソースをクリックしてテストします。テンプレート化されたリソースの場合は、パラメータの値を指定する必要があります。インスペクターには、mimeタイプやシリアライズされたデータを含め、クライアントが受け取る正確なレスポンス構造が表示されます。
実践的なユースケース
リソースは、チャットアプリケーションでのドキュメントメンションのような機能を実装するのに最適です。例えば、ユーザーが「@」と入力してドキュメントをメンションする場合、次のようにできます。
- 直接リソースを使用して、オートコンプリート用に利用可能なすべてのドキュメントの一覧を取得する
- テンプレート化されたリソースを使用して、メンションされた特定のドキュメントの内容を取得する
このアプローチにより、AIに情報を取得するためのツールを使用させることなく、ドキュメントの内容をプロンプトに事前に注入できます。