mcp-nutrition-db

mcp-nutrition-db — это приватный MCP-сервис, который позволяет ChatGPT записывать, исправлять и запрашивать данные о питании блюд и целях по питанию. ChatGPT интерпретирует фотографии блюд и контекст разговора; этот сервис владеет долговечными, аудируемыми данными.

Продакшн-сервис предназначен для работы на NixOS-хосте kage. Он слушает только loopback и доступен из ChatGPT через OpenAI Secure MCP Tunnel, поэтому ему не нужен маршрут nginx или публичный MCP-эндпоинт.

Документы проекта

• Системный дизайн определяет границы продукта, MCP-инструменты, модель данных, модель безопасности и развертывание на NixOS.

• План реализации — источник истины для этапов, критериев приемки, прогресса и отложенных работ.

• Локальное тестирование описывает прямое подключение Codex и временный сценарий Secure MCP Tunnel для ChatGPT Web.

План реализации должен обновляться в том же коммите, что и значимые вехи реализации. Изменения в дизайне должны записываться в журнал решений до или вместе с кодом, который от них зависит.

Related MCP server: cronometer-api-mcp

Текущий статус

Локальный MVP реализует схему SQLite и все восемь MCP-инструментов. Проверки репозитория, схемы, календаря, MCP-процесса, Streamable HTTP, пакета и вычисления NixOS проходят; точное проверенное состояние см. в плане реализации.

Разработка

Войдите в зафиксированное окружение и запустите проверки:

nix develop
PYTHONPATH=src ruff format --check src tests
PYTHONPATH=src ruff check src tests
PYTHONPATH=src mypy src
PYTHONPATH=src pytest

Запустите dev-сервер на loopback с одноразовым состоянием:

nix run . -- serve --database /tmp/mcp-nutrition-db.sqlite3

MCP-эндпоинт доступен по адресу http://127.0.0.1:8787/mcp; проверка готовности — по адресу http://127.0.0.1:8787/healthz. По умолчанию сервер отклоняет HTTP-привязку к адресу, отличному от loopback. См. локальное тестирование, чтобы подключить новую сессию Codex или запустить зафиксированный туннельный клиент для ChatGPT Web.