Инструмент-калькулятор от начала до конца
Создайте небольшой, но полностью рабочий арифметический инструмент.
«Инструмент-калькулятор от начала до конца» — бесплатный урок MCP Academy на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения MCP Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс MCP Academy содержит 4 уроков всего.
Создайте один полноценный инструмент
Давайте объединим всё в одном небольшом инструменте калькулятора — от понятного названия до чистого результата, которому модель может доверять. 🧮
Начните с сервера
Сначала создайте экземпляр FastMCP, который будет содержать инструмент. Дайте ему имя, чтобы клиенты могли идентифицировать Ваш сервер.
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("calculator")Назовите операцию
Выберите точное название. Мы будем складывать два числа, поэтому функция add понятна и Вам, и модели.
Объявите типизированные параметры
Используйте аннотации типов, чтобы модель отправляла числа, а не текст. Мы принимаем два значения с плавающей точкой, чтобы поддерживать как дробные, так и целые числа.
def add(a: float, b: float) -> float:
...Напишите строку документации
Строка документации становится описанием, поэтому ясно укажите, что делает инструмент и что он возвращает.
def add(a: float, b: float) -> float:
"""Add two numbers and return the sum."""Оформите его как инструмент
Добавьте декоратор инструмента, чтобы FastMCP зарегистрировал функцию и объявил её доступной для любого подключённого клиента.
@mcp.tool()
def add(a: float, b: float) -> float:
"""Add two numbers."""
return a + bВерните понятный результат
Возвращать сумму вполне достаточно, но результат с поясняющей подписью лучше читается и моделью, и пользователем, который видит ответ.
return a + bДобавьте второй инструмент
Один инструмент — одна задача, поэтому создайте отдельный инструмент divide, а не добавляйте режимы в add. Каждый инструмент остаётся простым для вызова.
@mcp.tool()
def divide(a: float, b: float) -> float:
return a / bЗащититесь от неправильных входных данных
Деление на ноль приведёт к сбою, поэтому сначала проверьте это и верните понятное сообщение об error, которое модель сможет прочитать и объяснить.
if b == 0:
return "Error: cannot divide by zero."Запустите сервер
Завершите код вызовом run, чтобы при запуске файла сервер начал работу и ожидал клиента через стандартный ввод-вывод.
if __name__ == "__main__":
mcp.run()Проверьте весь инструмент
Запустите его и попросите клиента перечислить ваши инструменты. Если вы видите add и divide с их описаниями, значит соединение настроено правильно.
Быстрая проверка
Почему для divide лучше создать отдельный инструмент, а не добавить флаг режима к add?
Итоги
Вы создали полноценный инструмент калькулятора: понятное имя, типизированные параметры, описание в строке документации, обработка ошибок и чистый результат, которому модель может доверять. ✅
Изучай Python с ИИ-репетитором — бесплатно
Пиши и запускай код прямо в браузере, получай мгновенную помощь от ИИ-репетитора 24/7 и продолжи учиться на сайте или в приложении.
- Курсы
- 30
- Уроки
- 120
Часто задаваемые вопросы
Урок «Инструмент-калькулятор от начала до конца» бесплатный?
Да — полный текст урока «Инструмент-калькулятор от начала до конца» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс MCP Academy, подпишись на CoddyKit PRO. Курс MCP Academy содержит 4 уроков всего.
Чему я научусь в уроке «Инструмент-калькулятор от начала до конца»?
Создайте небольшой, но полностью рабочий арифметический инструмент. Ты практикуешь MCP Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать MCP Academy?
Предыдущий опыт не требуется. MCP Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.
Сколько времени занимает урок «Инструмент-калькулятор от начала до конца»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке MCP Academy?
Да. Каждый урок MCP Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Грамотное имя и описание инструмента
- Объявление параметров с подсказками типов
- Возврат полезных результатов
- Инструмент-калькулятор от начала до конца