Преобразование REST API в инструменты
Превратите внешние конечные точки в вызываемые инструменты.
«Преобразование REST API в инструменты» — бесплатный урок MCP Academy на CoddyKit. Это урок 2 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения MCP Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс MCP Academy содержит 4 уроков всего.
Превратите конечные точки в инструменты
Любой REST API можно превратить в MCP tools. Каждая конечная точка становится вызываемой функцией, которую модель может использовать для получения или отправки данных. 🌐
Вызывайте HTTP из инструмента
Внутри инструмента выполните обычный запрос HTTP, а затем верните ответ в виде текста, который модель сможет прочитать и проанализировать.
Предпочитайте асинхронный клиент
Используйте асинхронный клиент, например httpx, чтобы медленный вызов API не блокировал другие запросы во время ожидания сети.
import httpx
async with httpx.AsyncClient() as client:
r = await client.get(url)Преобразуйте параметры в аргументы
Предоставьте параметры запроса конечной точки как arguments инструмента. Модель передаёт город или идентификатор, а Вы безопасно помещаете это значение в запрос.
@mcp.tool()
async def get_weather(city: str) -> str:
...Храните секреты на сервере
Храните API-key в окружении сервера, а не в аргументах инструмента. Модель не должна видеть или передавать учётные данные.
key = os.environ["WEATHER_API_KEY"]Проверьте код состояния
Проверьте HTTP-status, прежде чем доверять содержимому ответа. Код 404 или 500 означает, что нужно сообщить понятную ошибку, а не передавать бессмысленные данные.
r.raise_for_status()Разберите и сократите JSON
Большинство API возвращает JSON. Разберите его и верните только нужные для задачи fields, чтобы не перегружать модель лишними данными.
data = r.json()
return data["temp_c"]Назначьте каждому инструменту одну задачу
Сопоставляйте одну конечную точку с одним специализированным инструментом и понятным названием. Granular инструменты легче правильно выбрать модели.
Пишите полезные описания
Опишите назначение конечной точки и случаи её использования. Точное description помогает модели понять, когда нужно вызвать этот инструмент.
Обрабатывайте сбои сети
Оберните вызов так, чтобы тайм-аут или разрыв соединения возвращали понятное сообщение об error, а не приводили к сбою всего сервера.
Задавайте разумные тайм-ауты
Всегда передавайте timeout, чтобы зависший внешний сервис не остановил инструмент навсегда в ожидании ответа, который так и не поступит.
r = await client.get(url, timeout=10.0)Быстрая проверка
Где должен храниться ключ API?
Итоги: REST как инструменты
Вы обернули конечные точки в инструменты асинхронного выполнения: аргументы поступают на вход, ключи обрабатываются на сервере, статус проверяется, а на выходе получается очищенный JSON. Теперь займёмся пулом соединений. 🎯
Изучай Python с ИИ-репетитором — бесплатно
Пиши и запускай код прямо в браузере, получай мгновенную помощь от ИИ-репетитора 24/7 и продолжи учиться на сайте или в приложении.
- Курсы
- 30
- Уроки
- 120
Часто задаваемые вопросы
Урок «Преобразование REST API в инструменты» бесплатный?
Да — полный текст урока «Преобразование REST API в инструменты» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс MCP Academy, подпишись на CoddyKit PRO. Курс MCP Academy содержит 4 уроков всего.
Чему я научусь в уроке «Преобразование REST API в инструменты»?
Превратите внешние конечные точки в вызываемые инструменты. Ты практикуешь MCP Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать MCP Academy?
Предыдущий опыт не требуется. MCP Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 4.
Сколько времени занимает урок «Преобразование REST API в инструменты»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке MCP Academy?
Да. Каждый урок MCP Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Безопасное предоставление SQL-запросов
- Преобразование REST API в инструменты
- Пулы соединений в течение времени жизни
- Кэширование и ограничение частоты для вышестоящих сервисов