MealCP MCP

Официальный сервер Model Context Protocol для MealCP — слоя данных о продуктах и питании для ИИ-агентов.

Предоставляет два инструмента через публичный API MealCP:

• search_products — поиск по каталогу продуктов по ключевому слову с фильтрацией по фасетам (страна, ритейлер, сеть, бренд, тег, категория, город, диапазон цен, сортировка, пагинация).

• get_price_history — агрегированная статистика истории цен (мин/макс/среднее/первое/ последнее, чистое изменение) для одного продукта за диапазон дат.

Требования

• Python 3.10+

• API-ключ от MealCP (каждый вызов инструмента расходует 1 кредит)

Related MCP server: Swissgroceries MCP

Использование

Запуск напрямую с помощью uv:

uvx mealcp-mcp

Или установка:

pip install mealcp-mcp
mealcp-mcp

Сервер работает по протоколу MCP через stdio; любой MCP-хост (Claude Desktop, opencode, Cursor, …) может его запустить.

Claude Desktop

{
  "mcpServers": {
    "mealcp": {
      "command": "uvx",
      "args": ["mealcp-mcp"],
      "env": {
        "MEALCP_API_URL": "https://api.mealcp.com",
        "MEALCP_API_KEY": "mcp_live_your_key_here"
      }
    }
  }
}

opencode

{
  "mcp": {
    "mealcp": {
      "type": "local",
      "command": ["uvx", "mealcp-mcp"],
      "enabled": true,
      "environment": {
        "MEALCP_API_URL": "https://api.mealcp.com",
        "MEALCP_API_KEY": "mcp_live_your_key_here"
      }
    }
  }
}

Конфигурация

Ошибки

Ошибки инструментов возвращают стабильные токены ошибок API в формате <code>: <message> (например, not_found: Product not found). Ориентируйтесь на код, а не на сообщение.

Контракт

Модели ответов генерируются из OpenAPI-спецификации API (contract/openapi.json, текущая версия 0.1.0). Обновление:

uvx --from datamodel-code-generator datamodel-codegen \
  --input contract/openapi.json \
  --output src/mealcp_mcp/models.py \
  --output-model-type pydantic_v2.BaseModel \
  --target-python-version 3.10 --disable-timestamp

Разработка

uv sync
uv run pytest
uv run ruff check .

Лицензия

MIT