mise-en-place

MCP-сервер, который возвращает достоверные данные о макронутриентах для названного ингредиента в названном количестве, используя данные USDA FoodData Central.

У него одна задача: когда LLM планирует приём пищи или собирает рецепт, выдать реальные калории/белки/углеводы/жиры для реального продукта в реальном количестве, а никогда не правдоподобную догадку. Состав блюда, разработка рецепта и расчёты остаются заботой вызывающей модели. Единственное, что волнует этот сервер, — корректные входные данные.

Что это

mise-en-place — это не собственная база макронутриентов. Это сервис-надстройка для поиска данных по USDA FoodData Central, созданная так, чтобы LLM могла искать продукт, переводить количество («1 средняя луковица», «2 столовые ложки», «6 oz») в граммы и получать реальные, проверенные макроисточники вместо выдуманных. Он работает поверх MCP (stdio), поэтому любой MCP-совместимый клиент (Claude Code, Claude Desktop или любой другой, говорящий по этому протоколу) может подключиться к нему напрямую.

Восемь инструментов: search_foods, get_nutrition, get_nutrition_batch, save_override, save_recipe, get_recipe, get_recipe_history, list_recipes. Полные сигнатуры и схемы — в INTERFACES.md.

Related MCP server: Food Data Central MCP Server

Как его использовать

Требования: Python 3.9 и выше, бесплатный API-ключ USDA FoodData Central (мгновенная регистрация).

git clone <this repo>
cd mise-en-place
uv sync   # or: pip install -e .
export USDA_API_KEY=<your key>

Зарегистрируйте его в MCP-клиенте, например, в Claude Code:

claude mcp add mise-en-place -s local -e USDA_API_KEY=<your key> -- \
  uv run --directory /path/to/mise-en-place mise-en-place

Перезапустите клиент, чтобы он принял новое подключение, после чего просто задайте запрос о том, что готовите. Собственные instructions сервера (видны в _SERVER_INSTRUCTIONS файла server.py) передаются вместе с подключением и объясняют модели, как правильно использовать инструменты, поэтому вручную в чат ничего вставлять не нужно. Если вы ведёте регулярные сеансы планирования питания со своими целевыми нормами макро— смотрите MEAL_PLANNING_PROMPT.md. Эти нормы задаются персонально и на каждый приём пищи, поэтому сервер их никогда не хранит; единственное место, где они живут, — этот файл.

Личные исправления и сохранённые рецепты живут в ~/.mise-en-place/ (MISE_HOME) и никогда не попадают в коммиты. masses.toml в корне репозитория — единственная поставляемая таблица по умолчанию с весами типичных кухонных мер (средняя луковица, крупное яйцо, каб