SommelierX

Servidor MCP remoto para harmonização de vinhos nível sommelier. 7 ferramentas alimentadas por um algoritmo proprietário de DNA do Vinho. Chave de API ou pagamento por chamada x402.

GitHub

Experimente este MCPPatrocinado

Documentação

@sommelierx/mcp-server

Inteligência de harmonização de vinhos para assistentes de IA. Conecte Claude, Cursor, Windsurf ou qualquer cliente compatível com MCP a um algoritmo de harmonização de nível sommelier que combina vinhos com seus ingredientes, pratos e receitas.

Início Rápido

Claude Desktop

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json:

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

É isso. Pergunte ao Claude "Que vinho combina com salmão grelhado?" e ele usará o SommelierX para responder.

Com uma chave de API Pro

Para extração de receitas, harmonização em grupo e detalhamento de pontuações:

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

Cursor / Windsurf / Outros Clientes MCP

A mesma configuração funciona. Adicione o command e o args às configurações de MCP do seu cliente.

Ferramentas Disponíveis

Ferramenta	O que faz	Nível
`pair_wine_with_ingredients`	Encontra vinhos para uma lista de ingredientes (ex.: "salmão, limão, endro")	Grátis
`pair_wine_with_meal`	Encontra vinhos para um nome de prato (ex.: "risoto ai funghi")	Grátis
`find_meals_for_wine`	Encontra pratos que combinam com um estilo de vinho (ex.: "Barolo")	Grátis
`search_ingredients`	Pesquisa no banco de dados de ingredientes	Grátis
`search_meals`	Pesquisa no banco de dados de refeições	Grátis
`pair_wine_with_recipe_url`	Extrai ingredientes de uma URL de receita e harmoniza vinhos	Pro
`group_pairing`	Encontra o melhor vinho para vários pratos (ex.: jantar de 3 pratos)	Pro

Autenticação

O SommelierX suporta dois métodos de autenticação. Você pode usar qualquer um deles — não é necessário configurar ambos.

Opção 1: Chave de API (assinatura)

Defina a variável de ambiente SOMMELIERX_API_KEY na configuração do seu cliente MCP. O formato da chave é sk_live_.... Você recebe uma cota mensal de chamadas com base no seu nível (Grátis / Pro / Enterprise).

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

Obtenha sua chave de API em api.sommelierx.com.

Opção 2: Pagamento x402 (pague por chamada)

Não é necessária chave de API. Seu agente de IA paga por chamada usando USDC na rede Base por meio do protocolo Coinbase x402. Quando uma solicitação não tem chave de API, o servidor retorna uma resposta 402 Payment Required com um payload de pagamento. Agentes compatíveis com x402 lidam com isso automaticamente.

Isso é ideal para:

Agentes de IA que gerenciam sua própria carteira
Uso pré-pago sem assinatura
Comércio agente-a-agente (sem humano no processo)

Preços (por chamada)

Ferramenta	Preço	Nível
`pair_wine_with_meal`	$0.01	Grátis
`find_meals_for_wine`	$0.01	Grátis
`search_ingredients`	$0.005	Grátis
`search_meals`	$0.005	Grátis
`pair_wine_with_ingredients`	$0.02	Pro
`pair_wine_with_recipe_url`	$0.02	Pro
`group_pairing`	$0.03	Pro

Com uma chave de API, as chamadas são deduzidas da sua cota do nível. Com x402, cada chamada é cobrada pelo preço listado.

Exemplos de Conversas

Harmonização básica:

"Que vinho combina com salmão, aspargos e molho holandês?"

Harmonização reversa:

"Tenho uma garrafa de Barolo. O que devo cozinhar?"

URL de receita:

"Que vinho combina com esta receita? https://www.allrecipes.com/recipe/..."

Jantar para convidados:

"Estou planejando um jantar de 3 pratos: salada Caesar, costeleta de cordeiro e mousse de chocolate. Que vinho único funciona para todos os pratos?"

Como Funciona

Você faz uma pergunta sobre vinhos ao seu assistente de IA
O assistente chama a ferramenta apropriada do SommelierX
O servidor MCP traduz sua entrada em chamadas de API estruturadas
O algoritmo de harmonização do SommelierX (17 dimensões de DNA de alimentos x 19 dimensões de DNA de vinhos) calcula as correspondências
Você recebe recomendações de vinhos pontuadas com base em experiência real de sommelier

Resolução de Ingredientes

Quando você usa pair_wine_with_ingredients, o servidor resolve automaticamente nomes de ingredientes em linguagem natural para entradas do banco de dados. O assistente de IA não precisa saber IDs do banco de dados — ele passa os nomes dos ingredientes diretamente.

Configuração

Variável de Ambiente	Obrigatória	Padrão	Descrição
`SOMMELIERX_API_KEY`	Não	--	Chave de API para acesso Pro/Enterprise. Sem chave, nível grátis (50 chamadas/dia).
`SOMMELIERX_API_URL`	Não	`https://api.sommelierx.com`	URL base da API.
`SOMMELIERX_LANGUAGE`	Não	`en`	Idioma padrão para resultados (`en`, `nl`, `fr`, `de`, `es`, `it`).

Níveis de API

Nível	Limite Diário	Limite por Minuto	Recursos
Grátis	50 chamadas	2/min	Harmonização básica, pesquisa, consulta de ingredientes/refeições
Pro ($49/mês)	500 chamadas	20/min	+ Extração de URL de receita, harmonização em grupo, detalhamento de pontuações
Enterprise	10.000 chamadas	100/min	+ Limites personalizados, SLA

Obtenha sua chave de API em api.sommelierx.com

Documentação da API

A documentação completa da API está disponível em docs.sommelierx.com.

A especificação OpenAPI é servida em https://api.sommelierx.com/api/v1/openapi.json.

Desenvolvimento

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

Licença

MIT