Параметризованные URI ресурсов
Получайте переменные непосредственно из пути URI.
«Параметризованные URI ресурсов» — бесплатный урок MCP Academy на CoddyKit. Это урок 1 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения MCP Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс MCP Academy содержит 4 уроков всего.
Части этого урока еще не переведены и отображаются на английском.
One Pattern, Many Resources
A static resource has one fixed address. A parameterized URI is a pattern that stands in for a whole family of resources at once. ✨
Placeholders in Curly Braces
You mark the variable part of a URI with a placeholder in curly braces, like users://{user_id}/profile. That brace is a slot to fill.
users://{user_id}/profileThe Template Is a Promise
A resource template tells the client: any URI matching this shape is valid. The model can plug in real values to ask for exactly what it needs.
Decorate to Register
In the Python SDK you register a template the same way as a tool: with the @mcp.resource decorator, passing the URI pattern as its argument.
@mcp.resource("users://{user_id}/profile")
def get_profile(user_id: str) -> str:
return f"Profile for {user_id}"Names Must Match
Every placeholder in the URI must appear as a function parameter with the same name. The SDK wires {user_id} straight into your user_id argument.
Capture More Than One
You can capture several variables in one URI. Multiple placeholders each map to their own parameter, so one pattern can pinpoint very specific data.
@mcp.resource("repos://{owner}/{name}/readme")
def readme(owner: str, name: str) -> str:
return load_readme(owner, name)Values Arrive as Strings
Captured pieces come in as text from the URI. If you need a number, convert it yourself inside the function before using it.
def get_page(page: str) -> str:
n = int(page)
return render_page(n)One Segment Per Placeholder
By default a placeholder captures a single path segment, the text between two slashes. It stops at the next slash, so it won't swallow the rest of the path.
Templates Don't List Themselves
A plain resource shows up in the resource list. A templated resource usually does not, since there are endless possible URIs. The client reads it by filling the pattern.
Keep URIs Meaningful
Design URIs that read like clear addresses, such as weather://{city}/today. A model picks the right resource far more reliably when the path explains itself.
weather://{city}/todayWhy This Matters
Parameterized URIs let one tidy function serve thousands of resources. You write the shape once, and the variable parts do the rest. 🎯
Quick Check
How does a captured URI placeholder reach your function?
Recap
You learned that parameterized URIs use curly-brace placeholders to serve a whole family of resources, each one mapped to a matching function parameter. Next: building their content. 🚀
Часто задаваемые вопросы
Урок «Параметризованные URI ресурсов» бесплатный?
Да — полный текст урока «Параметризованные URI ресурсов» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс MCP Academy, подпишись на CoddyKit PRO. Курс MCP Academy содержит 4 уроков всего.
Чему я научусь в уроке «Параметризованные URI ресурсов»?
Получайте переменные непосредственно из пути URI. Ты практикуешь MCP Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать MCP Academy?
Предыдущий опыт не требуется. MCP Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 4.
Сколько времени занимает урок «Параметризованные URI ресурсов»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке MCP Academy?
Да. Каждый урок MCP Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Параметризованные URI ресурсов
- Формирование содержимого во время чтения
- Списки и шаблонные ресурсы
- Уведомление клиентов об обновлениях