О чём урок
В мире разработки систем на базе больших языковых моделей (LLM), таких как Claude, крайне важно обеспечить эффективный и структурированный доступ к внешним данным. Именно здесь на помощь приходят Ресурсы (Resources) в контексте серверов MCP (Model Control Plane). Представьте их как специализированные "точки доступа" на вашем сервере, которые позволяют клиентам — будь то сам Claude через инструменты или другие приложения — получать необходимую информацию.
По своей сути, ресурсы очень похожи на обработчики GET-запросов в традиционном HTTP-сервере. Их основное назначение — предоставление данных, а не выполнение каких-либо действий или модификация состояния. Это делает их идеальными для сценариев, где вам нужно извлечь информацию: например, получить список документов, прочитать содержимое файла или запросить конфигурационные параметры.
Чтобы лучше понять ресурсы, представьте их как доступные только для чтения конечные точки (read-only endpoints), способные возвращать данные любого типа. Это может быть простая текстовая строка, структурированный объект JSON, бинарный файл или любой другой формат, который может потребоваться вашему клиенту. Ключевым аспектом здесь является указание mime_type — это своего рода "подсказка" для клиента о том, какой тип данных он получит, что помогает ему правильно интерпретировать ответ.
Механизм работы ресурсов основан на использовании URI (Uniform Resource Identifier) — по сути, уникальных адресов, указывающих на конкретный ресурс. Когда клиенту требуются данные, он отправляет запрос ReadResourceRequest, содержащий нужный URI. Ваш сервер, в свою очередь, обрабатывает этот запрос и возвращает запрашиваемую информацию. Такая архитектура обеспечивает четкое разделение между запросом данных и их получением, делая систему более предсказуемой и управляемой.
В зависимости от того, как вы хотите организовать доступ к данным, вы можете создавать два основных типа ресурсов:
- Прямые Ресурсы (Direct Resources): Эти ресурсы имеют статические URI, которые не содержат никаких изменяемых параметров. Они идеально подходят для предоставления фиксированных наборов данных или информации, которая не требует специфических идентификаторов для доступа.
- Шаблонные Ресурсы (Templated Resources): В отличие от прямых, шаблонные ресурсы включают параметры в своих URI.
Создание ресурсов в…
План урока
- Введение в Ресурсы MCP: Доступ к Данным для Claude
- Понимание Концепции Ресурсов
- Два Основных Типа Ресурсов
- Реализация Ресурсов с помощью Python SDK
- Прямой Ресурс: Получение списка документов
- Шаблонный Ресурс: Получение содержимого конкретного документа
- Тестирование Ваших Ресурсов
- Практические Сценарии Использования Ресурсов
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.