Open Brewery DB

Busca y recupera datos de cervecerías en todo el mundo usando la API de Open Brewery DB.

GitHub
1
Prueba este MCPPatrocinado

Documentación

Open Brewery DB MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona acceso a la API de Open Brewery DB. Este servidor permite a los asistentes de IA y otros clientes MCP buscar cervecerías, obtener información detallada sobre ellas y explorar datos de cervecerías de todo el mundo.

Instalación

Desde npm (Recomendado)

Instala el paquete de forma global o como dependencia:

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

Inicio Rápido

Ejecutar con npx (sin necesidad de clonar)

npx open-brewery-db-mcp

O clonar y ejecutar localmente

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

Esto iniciará el servidor con el MCP Inspector, una interfaz web para probar y explorar todas las herramientas de cervecerías de forma interactiva.

Como servidor MCP (para clientes MCP)

El servidor se comunica a través de stdio y sigue el protocolo MCP. Para usarlo con un cliente MCP:

npm start
# or
node dist/index.js

Ejemplo de configuración de cliente MCP

Para conectar este servidor a un cliente MCP como Claude Desktop, añade la siguiente configuración:

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

O, si está instalado localmente o clonado:

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

Acerca de Open Brewery DB

Open Brewery DB es una API gratuita y de código abierto que proporciona información completa sobre cervecerías de todo el mundo. La base de datos incluye:

  • Más de 40,000 cervecerías de todo el mundo
  • Información detallada de las cervecerías, incluyendo nombres, tipos, ubicaciones y datos de contacto
  • Actualizaciones periódicas gracias a las contribuciones de la comunidad
  • No se requiere autenticación para el uso básico

Tipos de cervecerías

La API clasifica las cervecerías en varios tipos:

  • micro - La mayoría de las cervecerías artesanales. Por ejemplo, Samuel Adams todavía se considera una micro cervecería
  • nano - Una cervecería extremadamente pequeña que normalmente solo distribuye a nivel local
  • regional - Una ubicación regional de una cervecería expandida. Ej. Sierra Nevada Asheville
  • brewpub - Un restaurante o restaurante/bar enfocado en la cerveza con una cervecería en el local
  • large - (OBSOLETO) Una cervecería muy grande. Probablemente no apta para visitas. Ej. Miller-Coors
  • planning - Una cervecería en planificación o aún no abierta al público
  • bar - (OBSOLETO) Un bar. Sin equipo de cervecería en el local
  • contract - Una cervecería que utiliza el equipo de otra cervecería
  • proprietor - Similar al contract brewing pero se refiere a una incubadora de cervecerías
  • closed - Una ubicación que ha sido cerrada

Características

Este servidor MCP proporciona las siguientes herramientas:

🔍 search_breweries

Busca cervecerías con opciones de filtrado flexibles:

  • por nombre - Busca por nombre de cervecería
  • por ciudad - Filtra por nombre de ciudad
  • por estado - Filtra por estado (nombre completo o abreviatura)
  • por tipo - Filtra por tipo de cervecería (consulta los tipos anteriores)
  • paginación - Controla los resultados con los parámetros page y per_page

🏭 get_brewery_by_id

Obtén información detallada sobre una cervecería específica usando su ID único.

🎲 get_random_brewery

Descubre nuevas cervecerías obteniendo información aleatoria. Puedes especificar cuántas cervecerías aleatorias recuperar (1-10).

📋 list_brewery_types

Obtén una lista completa de todos los tipos de cervecerías disponibles con sus descripciones.

Uso

Desarrollo

Para desarrollo con el MCP Inspector (recomendado):

npm run dev

Este comando inicia el servidor con el MCP Inspector, que proporciona:

  • 🔍 Pruebas interactivas de todas las herramientas MCP
  • 📊 Depuración en tiempo real de las respuestas del servidor
  • 🎯 Exploración visual de herramientas con una interfaz web
  • 🚀 Retroalimentación instantánea sin necesidad de configurar un cliente MCP completo

El inspector se abrirá automáticamente en tu navegador, permitiéndote probar búsquedas de cervecerías, explorar cervecerías aleatorias y validar toda la funcionalidad en tiempo real.

Para observar cambios y recompilar (modo producción):

npm run watch

Ejemplos de API

Buscar cervecerías en Portland

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

Obtener una cervecería específica

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

Obtener 3 cervecerías aleatorias

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

Esquema de datos

Cada objeto de cervecería incluye la siguiente información:

{
  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)
}

Límites de uso

Open Brewery DB tiene límites de uso razonables:

  • No se requiere autenticación para el uso básico
  • Por favor, sé respetuoso con las llamadas a la API
  • Para un uso de alto volumen, considera almacenar en caché las respuestas

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request. Para cambios importantes, abre primero un issue para discutir lo que te gustaría cambiar.

Configuración de desarrollo

  1. Haz un fork del repositorio
  2. Crea tu rama de características (git checkout -b feature/amazing-feature)
  3. Realiza tus cambios
  4. Ejecuta las pruebas: npm test
  5. Haz commit de tus cambios (git commit -m 'feat: Add some amazing feature')
  6. Haz push a la rama (git push origin feature/amazing-feature)
  7. Abre un Pull Request

Contribuciones a los datos de cervecerías

¿Quieres ayudar a mejorar los datos de las cervecerías?
¡Las contribuciones a los listados y datos de cervecerías son bienvenidas! Consulta el repositorio de GitHub de Open Brewery DB para sugerir cambios, añadir nuevas cervecerías o ayudar a mantener el conjunto de datos.

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.

Agradecimientos

Soporte

Si encuentras algún problema o tienes preguntas:

  1. Consulta la documentación de Open Brewery DB
  2. Abre un issue en este repositorio
  3. Revisa los issues existentes para problemas similares

Nota: Este es un servidor MCP no oficial para Open Brewery DB. No está afiliado ni respaldado por Open Brewery DB.