MCP Academy · Урок

Добавление инструмента Hello

Добавьте декоратор к функции Python, чтобы искусственный интеллект мог её вызывать.

Урок 2 из 413 шагов

«Добавление инструмента Hello» — бесплатный урок MCP Academy на CoddyKit. Это урок 2 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения MCP Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс MCP Academy содержит 4 уроков всего.

Добавьте серверу умение

Сервер без инструментов — всего лишь оболочка. Инструмент — это функция Python, которую ИИ может вызвать, чтобы выполнить действие для пользователя. 🛠️

Волшебный декоратор

FastMCP превращает функцию в инструмент одной строкой: декоратором @mcp.tool(), размещённым непосредственно перед определением функции.

@mcp.tool()
def hello():
    ...

Напишите обычную функцию

Внутри находится обычный Python. Никакого специального кода протокола и ручного JSON. Вы описываете действие инструмента и возвращаете результат.

@mcp.tool()
def hello():
    return "Hello from MCP!"

Добавьте параметр

Входные данные делают инструменты полезнее. Добавьте параметр, и модель сможет передать значение, когда решит вызвать ваш инструмент.

@mcp.tool()
def greet(name):
    return "Hello, " + name

Аннотации типов создают схему

Добавьте аннотацию типа, например name: str, и FastMCP преобразует её во входную схему. После этого модель точно знает, значение какого типа нужно отправить.

@mcp.tool()
def greet(name: str) -> str:
    return "Hello, " + name

Строка документации становится описанием

Строка документации вашей функции становится описанием инструмента. Модель читает её, чтобы понять, когда этот инструмент подходит для использования.

@mcp.tool()
def greet(name: str) -> str:
    """Greet a person by name."""
    return "Hello, " + name

Имя берётся из функции

По умолчанию имя инструмента совпадает с именем функции. Поэтому def greet публикует инструмент, который клиент отображает как "greet".

Верните обычный текст

Для первого инструмента просто верните строку. FastMCP обернёт её в правильный формат результата MCP, и клиент получит обычный текст.

Хорошо его опишите

Формулировки важны: понятное описание помогает модели выбрать ваш инструмент в нужный момент. Расплывчатые строки документации приводят к пропущенным вызовам.

Регистрация выполняется автоматически

Вам не нужно самостоятельно вызывать функцию регистрации. После добавления декоратора инструмент регистрируется в экземпляре mcp и готов сообщить о себе.

Добавляйте сколько угодно

Один сервер может содержать много инструментов. Просто добавьте декоратор к каждой функции — все они появятся вместе, когда клиент запросит список доступных возможностей.

Быстрая проверка

Откуда берётся описание инструмента?

Ответь в интерактивном уроке

Итоги

Вы добавили инструмент с помощью @mcp.tool(), указали типы его параметров и позволили строке документации описать его. Теперь сервер наконец умеет что-то делать. Давайте его запустим! ✨

Можно начать бесплатно

Изучай Python с ИИ-репетитором — бесплатно

Пиши и запускай код прямо в браузере, получай мгновенную помощь от ИИ-репетитора 24/7 и продолжи учиться на сайте или в приложении.

Курсы: 30
Уроки: 120

Начать учиться бесплатно Посмотреть полный курс

Часто задаваемые вопросы

Урок «Добавление инструмента Hello» бесплатный?

Да — полный текст урока «Добавление инструмента Hello» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс MCP Academy, подпишись на CoddyKit PRO. Курс MCP Academy содержит 4 уроков всего.

Чему я научусь в уроке «Добавление инструмента Hello»?

Добавьте декоратор к функции Python, чтобы искусственный интеллект мог её вызывать. Ты практикуешь MCP Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать MCP Academy?

Предыдущий опыт не требуется. MCP Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 4.

Сколько времени занимает урок «Добавление инструмента Hello»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке MCP Academy?

Да. Каждый урок MCP Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к MCP Academy