SommelierX

Servidor MCP remoto para maridaje de vinos de nivel sumiller. 7 herramientas impulsadas por un algoritmo propietario Wine DNA. Clave API o pago por llamada x402.

GitHub

Prueba este MCPPatrocinado

Documentación

@sommelierx/mcp-server

Inteligencia de maridaje de vinos para asistentes de IA. Conecta Claude, Cursor, Windsurf o cualquier cliente compatible con MCP a un algoritmo de maridaje de nivel sumiller que combina vinos con tus ingredientes, platos y recetas.

Inicio Rápido

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "sommelierx": {
      "command": "npx",
      "args": ["@sommelierx/mcp-server"]
    }
  }
}

Eso es todo. Pregúntale a Claude "¿Qué vino va con salmón a la parrilla?" y usará SommelierX para responder.

Con una clave API Pro

Para extracción de recetas, emparejamiento en grupo y desgloses de puntuación:

{
  "mcpServers": {
    "sommelierx": {
      "command": "npx",
      "args": ["@sommelierx/mcp-server"],
      "env": {
        "SOMMELIERX_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cursor / Windsurf / Otros clientes MCP

La misma configuración funciona. Añade command y args a la configuración MCP de tu cliente.

Herramientas Disponibles

Herramienta	Qué hace	Nivel
`pair_wine_with_ingredients`	Encuentra vinos para una lista de ingredientes (p. ej. "salmón, limón, eneldo")	Gratis
`pair_wine_with_meal`	Encuentra vinos para un nombre de plato (p. ej. "risotto ai funghi")	Gratis
`find_meals_for_wine`	Encuentra platos que combinan con un estilo de vino (p. ej. "Barolo")	Gratis
`search_ingredients`	Busca en la base de datos de ingredientes	Gratis
`search_meals`	Busca en la base de datos de comidas	Gratis
`pair_wine_with_recipe_url`	Extrae ingredientes de una URL de receta y combina vinos	Pro
`group_pairing`	Encuentra el mejor vino para múltiples platos (p. ej. cena de 3 platos)	Pro

Autenticación

SommelierX admite dos métodos de autenticación. Puedes usar cualquiera de los dos -- no es necesario configurar ambos.

Opción 1: Clave API (suscripción)

Establece la variable de entorno SOMMELIERX_API_KEY en la configuración de tu cliente MCP. El formato de la clave es sk_live_.... Obtienes una asignación mensual de llamadas según tu nivel (Gratis / Pro / Empresa).

{
  "mcpServers": {
    "sommelierx": {
      "command": "npx",
      "args": ["@sommelierx/mcp-server"],
      "env": {
        "SOMMELIERX_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Obtén tu clave API en api.sommelierx.com.

Opción 2: Pago x402 (pago por llamada)

No se necesita clave API. Tu agente de IA paga por llamada usando USDC en la red Base a través del protocolo Coinbase x402. Cuando una solicitud no tiene clave API, el servidor devuelve una respuesta 402 Payment Required con un payload de pago. Los agentes compatibles con x402 manejan esto automáticamente.

Esto es ideal para:

Agentes de IA que gestionan su propia billetera
Uso de pago por uso sin suscripción
Comercio agente a agente (sin intervención humana)

Precios (por llamada)

Herramienta	Precio	Nivel
`pair_wine_with_meal`	$0.01	Gratis
`find_meals_for_wine`	$0.01	Gratis
`search_ingredients`	$0.005	Gratis
`search_meals`	$0.005	Gratis
`pair_wine_with_ingredients`	$0.02	Pro
`pair_wine_with_recipe_url`	$0.02	Pro
`group_pairing`	$0.03	Pro

Con una clave API, las llamadas se descuentan de tu asignación de nivel. Con x402, cada llamada se cobra al precio indicado.

Ejemplos de Conversaciones

Emparejamiento básico:

"¿Qué vino combina bien con salmón, espárragos y salsa holandesa?"

Emparejamiento inverso:

"Tengo una botella de Barolo. ¿Qué debería cocinar?"

URL de receta:

"¿Qué vino va con esta receta? https://www.allrecipes.com/recipe/..."

Cena con invitados:

"Estoy planeando una cena de 3 platos: ensalada César, costillar de cordero y mousse de chocolate. ¿Qué vino único funciona para todos los platos?"

Cómo Funciona

Le haces una pregunta sobre vino a tu asistente de IA
El asistente llama a la herramienta adecuada de SommelierX
El servidor MCP traduce tu entrada en llamadas API estructuradas
El algoritmo de emparejamiento de SommelierX (17 dimensiones de ADN de alimentos x 19 dimensiones de ADN de vinos) calcula coincidencias
Obtienes recomendaciones de vinos puntuadas basadas en experiencia real de sumiller

Resolución de Ingredientes

Cuando usas pair_wine_with_ingredients, el servidor resuelve automáticamente los nombres de ingredientes en lenguaje natural a entradas de la base de datos. El asistente de IA no necesita conocer los IDs de la base de datos -- pasa los nombres de ingredientes directamente.

Configuración

Variable de Entorno	Requerida	Predeterminado	Descripción
`SOMMELIERX_API_KEY`	No	--	Clave API para acceso Pro/Empresa. Sin clave, nivel gratuito (50 llamadas/día).
`SOMMELIERX_API_URL`	No	`https://api.sommelierx.com`	URL base de la API.
`SOMMELIERX_LANGUAGE`	No	`en`	Idioma predeterminado para los resultados (`en`, `nl`, `fr`, `de`, `es`, `it`).

Niveles de API

Nivel	Límite Diario	Límite por Minuto	Características
Gratis	50 llamadas	2/min	Emparejamiento básico, búsqueda, consulta de ingredientes/comidas
Pro ($49/mes)	500 llamadas	20/min	+ Extracción de URL de recetas, emparejamiento en grupo, desgloses de puntuación
Empresa	10,000 llamadas	100/min	+ Límites personalizados, SLA

Obtén tu clave API en api.sommelierx.com

Documentación de la API

La documentación completa de la API está disponible en docs.sommelierx.com.

La especificación OpenAPI se sirve en https://api.sommelierx.com/api/v1/openapi.json.

Desarrollo

npm install
npm run build
npm run dev       # development mode with hot reload
npm run typecheck # type checking without emit

Requisitos

Node.js >= 18.0.0

Licencia

MIT