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"]
    }
  }
}