MealCP MCP

Servidor oficial de Model Context Protocol para MealCP — la capa de datos de comestibles y alimentos para agentes de IA.

Expone dos herramientas a través de la API pública de MealCP:

• search_products — busca en el catálogo de productos de comestibles por palabra clave con filtrado por facetas (país, minorista, cadena, marca, etiqueta, categoría, ciudad, rango de precios, orden, paginación).

• get_price_history — estadísticas agregadas del historial de precios (mín/máx/promedio/primero/ último, cambio neto) para un producto en un rango de fechas.

Requisitos

• Python 3.10+

• Una clave de API de MealCP (cada llamada a herramienta consume 1 crédito)

Related MCP server: Swissgroceries MCP

Uso

Ejecuta directamente con uv:

uvx mealcp-mcp

O instala:

pip install mealcp-mcp
mealcp-mcp

El servidor habla MCP sobre stdio; cualquier host MCP (Claude Desktop, opencode, Cursor, …) puede iniciarlo.

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

Configuración

Errores

Los errores de las herramientas muestran los tokens de error estables de la API, con el formato <code>: <message> (p. ej., not_found: Product not found). Basa la lógica en el código, nunca en el mensaje.

Contrato

Los modelos de respuesta se generan a partir de la especificación OpenAPI de la API (contract/openapi.json, actualmente versión 0.1.0). Actualiza con:

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

Desarrollo

uv sync
uv run pytest
uv run ruff check .

Licencia

MIT