Описываем инструменты через MCP

Урок 67 из 100 курса «Claude в Google Vertex AI»: официальный курс Anthropic Academy (Антропик) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

Кадр из видеоурока

О чём урок

В мире больших языковых моделей (LLM), таких как Claude, способность взаимодействовать с внешним миром имеет решающее значение. Хотя Claude может генерировать текст, отвечать на вопросы и даже писать код, его возможности ограничены его "внутренним" знанием. Чтобы Claude мог выполнять действия в реальном мире — например, получать актуальные данные из интернета, управлять файлами, взаимодействовать с базами данных или вызывать сторонние API — ему необходимы инструменты. MCP (Multi-tool Co-pilot) — это фреймворк, разработанный Anthropic, который позволяет Claude использовать такие внешние инструменты. Традиционно определение этих инструментов требовало написания сложных схем в формате JSON, что могло быть трудоемким и подверженным ошибкам. Однако с появлением официального Python SDK для MCP процесс создания и интеграции инструментов значительно упростился, превратившись из ручного кодирования схем в интуитивно понятное определение функций Python. Python SDK для MCP кардинально меняет подход к созданию инструментов. Вместо того чтобы вручную описывать каждую функцию и ее параметры в виде JSON schema, разработчики могут использовать декораторы Python. SDK берет на себя всю "тяжелую работу" по генерации необходимых метаданных, которые Claude использует для понимания того, когда и как вызывать ваши инструменты. Этот подход не только ускоряет разработку, но и делает код более читаемым, поддерживаемым и менее подверженным ошибкам. Инструменты становятся обычными функциями Python, что позволяет использовать привычные методы тестирования и отладки. Сервер MCP является центральным компонентом, который управляет определениями инструментов, клиентскими подключениями и маршрутизацией сообщений между Claude и вашими инструментами. Python SDK делает инициализацию такого сервера невероятно простой. Например, вы можете создать полностью функциональный сервер всего одной строкой кода: В этом примере мы инициализируем сервер FastMCP с именем "DocumentMCP". Параметр log_level="ERROR" настраивает уровень логирования, чтобы выводить только критические ошибки. Этот сервер готов принимать определения инструментов и обрабатывать запросы от Claude. Основное преимущество SDK заключается в использовании декораторов для определения инструментов.

План урока

  1. Определение инструментов для Claude с помощью MCP и Python SDK
  2. Упрощение разработки инструментов с помощью Python SDK для MCP
  3. Настройка сервера MCP
  4. Определение инструментов с помощью декораторов
  5. Примеры практических инструментов: Управление документами
  6. Инструмент для чтения документов
  7. Инструмент для редактирования документов
  8. Ключевые преимущества подхода с SDK

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Урок входит в темы

Полезные гиды