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

Скільки замовлень скасовано?

Сколько заказов отменено?

claude mcp add demo -- uv run mcp run server.py

python gen_orders.py C:\data\tri-zerna

# Завдання: сервер MCP над замовленнями «Три зерна»

Дані вигадані, компанії «Три зерна» не існує. Замовлення кав'ярні лежать у файлі
`orders.json` за абсолютним шляхом поза папкою сервера (у ролику — `C:\data\tri-zerna\orders.json`),
у вигляді списку з двохсот записів.
У кожного замовлення є номер, дата, клієнт (назва кафе), місто, товар, кількість, ціна за
одиницю, сума, статус і менеджер.

Напиши сервер MCP на Python, який віддає моделі три інструменти для роботи з цими замовленнями:

1. **Список замовлень** — з необов'язковими фільтрами за статусом і за містом та з обмеженням на
   кількість записів, що повертаються (за замовчуванням двадцять).
2. **Пошук замовлень** — за підрядком, який шукається і в назві клієнта, і в назві товару.
3. **Картка замовлення** — усі поля одного замовлення за його номером.

Вимоги:
- сервер працює через stdio, окремого мережевого порту не піднімає;
- у кожного інструмента є короткий опис для моделі — одне речення російською мовою,
  без канцеляризму, по суті того, що інструмент повертає;
- весь файл сервера — не довший за шістдесят рядків;
- використовуй актуальний на сьогодні Python SDK для MCP — знайди в його свіжій документації потрібний
  клас сервера і спосіб реєстрації інструмента сам, не покладайся на те, що ти про нього вже
  знаєш.

Сервер не зберігає і не приймає жодних секретів: він лише читає файл із замовленнями.

# Задача: сервер MCP над заказами «Три зерна»

Данные вымышленные, компания «Три зерна» не существует. Заказы кофейной лавки лежат в файле
`orders.json` по абсолютному пути вне папки сервера (в ролике — `C:\data\tri-zerna\orders.json`),
в виде списка из двухсот записей.
У каждого заказа есть номер, дата, клиент (название кафе), город, товар, количество, цена за
единицу, сумма, статус и менеджер.

Напиши сервер MCP на Python, который отдаёт модели три инструмента для работы с этими заказами:

1. **Список заказов** — с необязательными фильтрами по статусу и по городу и с ограничением на
   число возвращаемых записей (по умолчанию двадцать).
2. **Поиск заказов** — по подстроке, которая ищется и в названии клиента, и в названии товара.
3. **Карточка заказа** — все поля одного заказа по его номеру.

Требования:
- сервер работает через stdio, отдельного сетевого порта не поднимает;
- у каждого инструмента есть краткое описание для модели — одно предложение на русском языке,
  без канцелярита, по существу того, что инструмент возвращает;
- весь файл сервера — не длиннее шестидесяти строк;
- используй актуальный на сегодня Python SDK для MCP — найди в его свежей документации нужный
  класс сервера и способ регистрации инструмента сам, не полагайся на то, что ты про него уже
  знаешь.

Сервер не хранит и не принимает никаких секретов: он только читает файл с заказами.

{
  "mcpServers": {
    "orders": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "mcp", "run", "server.py"]
    }
  }
}