パラメーター付きリソースURI
URIパスから変数を直接取得します。
「パラメーター付きリソースURI」はCoddyKit上の無料MCP Academyレッスンです。 これはレッスン1/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはMCP Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 MCP Academyコースには全4レッスンが含まれています。
1つのパターンで多数のResource
静的なresourceには1つの固定アドレスがあります。パラメーター化されたURIは、一度に多数のresourceからなる集合を表すパターンです。✨
波括弧内のプレースホルダー
URIの可変部分は、users://{user_id}/profileのように波括弧内のプレースホルダーで示します。この波括弧部分が値を入れるスロットになります。
users://{user_id}/profileテンプレートは約束
resource templateは、これに一致する形のURIがすべて有効であることをクライアントに伝えます。モデルは実際の値を入れて、必要なデータだけを要求できます。
デコレーターで登録する
Python SDKでは、ツールと同じ方法でテンプレートを登録します。@mcp.resourceデコレーターにURIパターンを引数として渡します。
@mcp.resource("users://{user_id}/profile")
def get_profile(user_id: str) -> str:
return f"Profile for {user_id}"名前を一致させる
URI内のすべてのプレースホルダーは、同じ名前の関数パラメーターとして登場させる必要があります。SDKは{user_id}をそのままuser_id引数に渡します。
複数の値を取得する
1つのURIから複数の変数を取得できます。複数のプレースホルダーがそれぞれ固有のパラメーターに対応するため、1つのパターンで非常に具体的なデータを指定できます。
@mcp.resource("repos://{owner}/{name}/readme")
def readme(owner: str, name: str) -> str:
return load_readme(owner, name)値は文字列として渡される
取得した部分はURIからテキストとして渡されます。数値が必要な場合は、関数内で使う前に自分で変換します。
def get_page(page: str) -> str:
n = int(page)
return render_page(n)プレースホルダー1つにつき1セグメント
デフォルトでは、プレースホルダーは1つのパスセグメント、つまり2つのスラッシュの間にあるテキストを取得します。次のスラッシュで止まるため、パスの残りまで取り込むことはありません。
テンプレートは自動的に一覧表示されない
通常のresourceはresource listに表示されます。一方、テンプレート化されたresourceはURIの候補が無限にあるため、通常は表示されません。クライアントはパターンに値を入れて読み取ります。
意味のあるURIを保つ
weather://{city}/todayのように、明確なアドレスとして読めるURIを設計します。パス自体が内容を説明していると、モデルは適切なresourceをより確実に選べます。
weather://{city}/todayこれが重要な理由
パラメーター化されたURIを使えば、1つの整理された関数で何千ものresourceを提供できます。形を一度書けば、あとは可変部分が処理してくれます。🎯
確認問題
URIから取得したプレースホルダーは、どのように関数へ渡されますか？
振り返り
パラメーター化されたURIでは、波括弧のプレースホルダーを使ってresourceの集合全体を提供し、それぞれを対応する関数パラメーターに割り当てることを学びました。次は、そのコンテンツを作成します。🚀
AI チューターと学ぶ Python — 無料
ブラウザでリアルコードを書いて実行し、24/7 の AI チューターから瞬時にサポートを受け、ウェブまたはアプリで続きから学習できます。
- コース
- 30
- レッスン
- 120
よくある質問
「パラメーター付きリソースURI」レッスンは無料ですか？
はい。「パラメーター付きリソースURI」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、MCP Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 MCP Academyコースには全4レッスンが含まれています。
「パラメーター付きリソースURI」で何を学びますか？
URIパスから変数を直接取得します。 ブラウザで直接実行するハンズオンコードでMCP Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
MCP Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのMCP Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン1/4です。
「パラメーター付きリソースURI」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このMCP Academyレッスンでコードを書いて実行できますか？
はい。すべてのMCP Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- パラメーター付きリソースURI
- 読み取り時にコンテンツを生成する
- 一覧型リソースとテンプレート型リソース
- 更新をクライアントに通知する