Open Brewery DB

Pesquise e recupere dados de cervejarias em todo o mundo usando a API Open Brewery DB.

Documentação

Open Brewery DB MCP Server

Um servidor Model Context Protocol (MCP) que fornece acesso à API do Open Brewery DB. Este servidor permite que assistentes de IA e outros clientes MCP pesquisem cervejarias, obtenham informações detalhadas sobre cervejarias e explorem dados de cervejarias de todo o mundo.

Instalação

Via npm (Recomendado)

Instale o pacote globalmente ou como dependência:

npm install -g @jimbuck/open-brewery-db-mcp
# or for local usage
npm install @jimbuck/open-brewery-db-mcp

Início Rápido

Execute com npx (sem necessidade de clonar)

npx open-brewery-db-mcp

Ou clone e execute localmente

git clone https://github.com/your-username/open-brewery-db-mcp.git
cd open-brewery-db-mcp
npm install
npm run dev

Isso iniciará o servidor com o MCP Inspector - uma interface baseada na web para testar e explorar todas as ferramentas de cervejarias de forma interativa!

Como um Servidor MCP (para clientes MCP)

O servidor se comunica via stdio e segue o protocolo MCP. Para usá-lo com um cliente MCP:

npm start
# or
node dist/index.js

Exemplo de Configuração de Cliente MCP

Para conectar este servidor a um cliente MCP como o Claude Desktop, adicione a seguinte configuração:

macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "open-brewery-db": {
      "command": "npx",
      "args": ["@jimbuck/open-brewery-db-mcp"]
    }
  }
}

Ou, se instalado localmente ou clonado:

{
  "mcpServers": {
    "open-brewery-db": {
      "command": "node",
      "args": ["/path/to/open-brewery-db-mcp/dist/index.js"]
    }
  }
}

Sobre o Open Brewery DB

Open Brewery DB é uma API gratuita e de código aberto que fornece informações abrangentes sobre cervejarias em todo o mundo. O banco de dados inclui:

Mais de 40.000 cervejarias de todo o mundo
Informações detalhadas sobre cervejarias, incluindo nomes, tipos, localizações e dados de contato
Atualizações regulares a partir de contribuições da comunidade
Nenhuma autenticação necessária para uso básico

Tipos de Cervejarias

A API categoriza as cervejarias em vários tipos:

micro - A maioria das cervejarias artesanais. Por exemplo, a Samuel Adams ainda é considerada uma micro cervejaria
nano - Uma cervejaria extremamente pequena que normalmente distribui apenas localmente
regional - Uma localização regional de uma cervejaria expandida. Ex.: Sierra Nevada Asheville
brewpub - Um restaurante focado em cerveja ou restaurante/bar com uma cervejaria no local
large - (OBSOLETO) Uma cervejaria muito grande. Provavelmente não é para visitantes. Ex.: Miller-Coors
planning - Uma cervejaria em planejamento ou ainda não aberta ao público
bar - (OBSOLETO) Um bar. Sem equipamento de cervejaria no local
contract - Uma cervejaria que utiliza o equipamento de outra cervejaria
proprietor - Semelhante à produção por contrato, mas refere-se a uma incubadora de cervejarias
closed - Um local que foi fechado

Recursos

Este servidor MCP fornece as seguintes ferramentas:

🔍 `search_breweries`

Pesquise cervejarias com opções flexíveis de filtro:

por nome - Pesquise pelo nome da cervejaria
por cidade - Filtre pelo nome da cidade
por estado - Filtre por estado (nome completo ou abreviação)
por tipo - Filtre pelo tipo de cervejaria (veja os tipos acima)
paginação - Controle os resultados com os parâmetros page e per_page

🏭 `get_brewery_by_id`

Obtenha informações detalhadas sobre uma cervejaria específica usando seu ID exclusivo.

🎲 `get_random_brewery`

Descubra novas cervejarias obtendo informações aleatórias de cervejarias. Você pode especificar quantas cervejarias aleatórias deseja recuperar (1-10).

📋 `list_brewery_types`

Obtenha uma lista completa de todos os tipos de cervejarias disponíveis com descrições.

Uso

Desenvolvimento

Para desenvolvimento com o MCP Inspector (recomendado):

npm run dev

Este comando inicia o servidor com o MCP Inspector, que fornece:

🔍 Testes interativos de todas as ferramentas MCP
📊 Depuração em tempo real das respostas do servidor
🎯 Exploração visual de ferramentas com uma interface baseada na web
🚀 Feedback instantâneo sem precisar configurar um cliente MCP completo

O inspector abrirá automaticamente no seu navegador, permitindo testar pesquisas de cervejarias, explorar cervejarias aleatórias e validar toda a funcionalidade em tempo real.

Para observar alterações e recompilar (modo de produção):

npm run watch

Exemplos de API

Pesquisar cervejarias em Portland

{
  "name": "search_breweries",
  "arguments": {
    "by_city": "Portland",
    "by_state": "Oregon",
    "per_page": 10
  }
}

Obter uma cervejaria específica

{
  "name": "get_brewery_by_id",
  "arguments": {
    "id": "11590"
  }
}

Obter 3 cervejarias aleatórias

{
  "name": "get_random_brewery",
  "arguments": {
    "size": 3
  }
}

Esquema de Dados

Cada objeto de cervejaria inclui as seguintes informações:

{
  id: string;                    // Unique identifier
  name: string;                  // Brewery name
  brewery_type: BreweryType;     // Type of brewery
  address_1?: string;            // Street address
  address_2?: string;            // Additional address info
  address_3?: string;            // Additional address info
  city?: string;                 // City name
  state_province?: string;       // State or province
  postal_code?: string;          // Postal/ZIP code
  country?: string;              // Country
  longitude?: string;            // GPS longitude
  latitude?: string;             // GPS latitude
  phone?: string;                // Phone number
  website_url?: string;          // Website URL
  state?: string;                // US state code
  street?: string;               // Street address (alternative)
}

Limite de Taxa

O Open Brewery DB tem limites de taxa razoáveis:

Nenhuma autenticação necessária para uso básico
Por favor, seja respeitoso com as chamadas de API
Para uso de alto volume, considere armazenar respostas em cache

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request. Para mudanças significativas, abra uma issue primeiro para discutir o que você gostaria de alterar.

Configuração de Desenvolvimento

Faça um fork do repositório
Crie sua branch de recurso (git checkout -b feature/amazing-feature)
Faça suas alterações
Execute os testes: npm test
Faça commit das suas alterações (git commit -m 'feat: Add some amazing feature')
Envie para a branch (git push origin feature/amazing-feature)
Abra um Pull Request

Contribuições de Dados de Cervejarias

Quer ajudar a melhorar os próprios dados das cervejarias?
Contribuições para as listagens e dados de cervejarias são bem-vindas! Confira o repositório GitHub do Open Brewery DB para sugerir alterações, adicionar novas cervejarias ou ajudar a manter o conjunto de dados.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Agradecimentos

Open Brewery DB por fornecer a excelente API de cervejarias
Model Context Protocol pela especificação do protocolo
Todos os contribuidores dos dados de cervejarias

Suporte

Se você encontrar problemas ou tiver dúvidas:

Consulte a documentação do Open Brewery DB
Abra uma issue neste repositório
Verifique as issues existentes para problemas semelhantes

Nota: Este é um servidor MCP não oficial para o Open Brewery DB. Ele não é afiliado nem endossado pelo Open Brewery DB.