Андрій · AI під роботу

Усі уроки

02

MCP з нуля: підключаю Claude до своїх даних за 20 хвилин

14:28 · 11 кроків

1 Репозиторій матеріалів github.com
  1. 1 00:00 Те саме запитання, той самий Claude: до і після
  2. 2 01:10 Навіщо взагалі потрібен MCP: де закінчується модель
  3. 3 02:10 Готовий сервер з документації: підключення і перший виклик
  4. 4 04:21 Дані: генератор і двісті вигаданих замовлень
  5. 5 05:25 Свій сервер: завдання словами, а не синтаксисом

    1 Що робити

    Віддаю Claude Code завдання словами, він сам знаходить свіжий SDK і пише сервер на три інструменти.

    2 Промпт

    UK · Промпт
    # Завдання: сервер MCP над замовленнями «Три зерна»
    
    Дані вигадані, компанії «Три зерна» не існує. Замовлення кав'ярні лежать у файлі
    `orders.json` за абсолютним шляхом поза папкою сервера (у ролику — `C:\data\tri-zerna\orders.json`),
    у вигляді списку з двохсот записів.
    У кожного замовлення є номер, дата, клієнт (назва кафе), місто, товар, кількість, ціна за
    одиницю, сума, статус і менеджер.
    
    Напиши сервер MCP на Python, який віддає моделі три інструменти для роботи з цими замовленнями:
    
    1. **Список замовлень** — з необов'язковими фільтрами за статусом і за містом та з обмеженням на
       кількість записів, що повертаються (за замовчуванням двадцять).
    2. **Пошук замовлень** — за підрядком, який шукається і в назві клієнта, і в назві товару.
    3. **Картка замовлення** — усі поля одного замовлення за його номером.
    
    Вимоги:
    - сервер працює через stdio, окремого мережевого порту не піднімає;
    - у кожного інструмента є короткий опис для моделі — одне речення російською мовою,
      без канцеляризму, по суті того, що інструмент повертає;
    - весь файл сервера — не довший за шістдесят рядків;
    - використовуй актуальний на сьогодні Python SDK для MCP — знайди в його свіжій документації потрібний
      клас сервера і спосіб реєстрації інструмента сам, не покладайся на те, що ти про нього вже
      знаєш.
    
    Сервер не зберігає і не приймає жодних секретів: він лише читає файл із замовленнями.
    EN · Промпт з екрана
    # Задача: сервер MCP над заказами «Три зерна»
    
    Данные вымышленные, компания «Три зерна» не существует. Заказы кофейной лавки лежат в файле
    `orders.json` по абсолютному пути вне папки сервера (в ролике — `C:\data\tri-zerna\orders.json`),
    в виде списка из двухсот записей.
    У каждого заказа есть номер, дата, клиент (название кафе), город, товар, количество, цена за
    единицу, сумма, статус и менеджер.
    
    Напиши сервер MCP на Python, который отдаёт модели три инструмента для работы с этими заказами:
    
    1. **Список заказов** — с необязательными фильтрами по статусу и по городу и с ограничением на
       число возвращаемых записей (по умолчанию двадцать).
    2. **Поиск заказов** — по подстроке, которая ищется и в названии клиента, и в названии товара.
    3. **Карточка заказа** — все поля одного заказа по его номеру.
    
    Требования:
    - сервер работает через stdio, отдельного сетевого порта не поднимает;
    - у каждого инструмента есть краткое описание для модели — одно предложение на русском языке,
      без канцелярита, по существу того, что инструмент возвращает;
    - весь файл сервера — не длиннее шестидесяти строк;
    - используй актуальный на сегодня Python SDK для MCP — найди в его свежей документации нужный
      класс сервера и способ регистрации инструмента сам, не полагайся на то, что ты про него уже
      знаешь.
    
    Сервер не хранит и не принимает никаких секретов: он только читает файл с заказами.

    Запитати в Telegram

  6. 6 07:35 Реєстрація в .mcp.json, перезапуск, три рівні
  7. 7 08:55 Що видно, коли модель кличе інструмент
  8. 8 09:43 Прогін: п'ять запитань, п'яте — про обсяг
  9. 9 11:14 Де ламається: секрети, ліміти, коли простіше скрипт
  10. 10 13:36 Домашка
  11. 11 14:14 Що далі