Open Brewery DB

Open Brewery DB MCP 服务

一个 Model Context Protocol (MCP) 服务，可访问 Open Brewery DB API。此服务让 AI 助手和其他 MCP 客户端能够搜索啤酒厂、获取详细的啤酒厂信息，并探索世界各地的啤酒厂数据。

安装

从 npm 安装（推荐）

全局安装该包，或将其作为依赖项安装：

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

快速开始

使用 npx 运行（无需克隆）

npx open-brewery-db-mcp

或克隆并在本地运行

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

这将通过 MCP Inspector 启动服务——这是一个基于 Web 的界面，可用于交互式测试和探索所有啤酒厂工具！

作为 MCP 服务（供 MCP 客户端使用）

该服务通过 stdio 通信，并遵循 MCP 协议。要将其与 MCP 客户端配合使用：

npm start
# or
node dist/index.js

MCP 客户端配置示例

要将此服务连接到 Claude Desktop 等 MCP 客户端，请添加以下配置：

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

或者，如果已在本地安装或克隆：

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

关于 Open Brewery DB

Open Brewery DB 是一个免费开源 API，提供全球啤酒厂的全面信息。该数据库包括：

• 40,000 多家啤酒厂，遍布世界各地
• 详细的啤酒厂信息，包括名称、类型、位置和联系方式
• 根据社区贡献定期更新
• 基本使用无需身份验证

啤酒厂类型

该 API 将啤酒厂分为以下几种类型：

• micro - 大多数精酿啤酒厂。例如，Samuel Adams 仍被视为小型啤酒厂
• nano - 规模极小的啤酒厂，通常只在当地销售产品
• regional - 扩大经营的啤酒厂在某个地区的分店。例如，Sierra Nevada Asheville
• brewpub - 以啤酒为主的餐厅，或设有啤酒厂的餐厅／酒吧
• large -（已弃用）规模非常大的啤酒厂。可能不对访客开放。例如，Miller-Coors
• planning - 正在筹备或尚未向公众开放的啤酒厂
• bar -（已弃用）酒吧，场所内没有啤酒酿造设备
• contract - 使用其他啤酒厂设备的啤酒厂
• proprietor - 与委托酿造类似，但指啤酒厂孵化器
• closed - 已关闭的场所

功能

此 MCP 服务提供以下工具：

🔍 search_breweries

使用灵活的筛选选项搜索啤酒厂：

• 按名称 - 按啤酒厂名称搜索
• 按城市 - 按城市名称筛选
• 按州 - 按州筛选（全名或缩写）
• 按类型 - 按啤酒厂类型筛选（参见上方类型）
• 分页 - 使用 page 和 per_page 参数控制结果

🏭 get_brewery_by_id

使用啤酒厂的唯一 ID 获取其详细信息。

🎲 get_random_brewery

获取随机啤酒厂信息，探索新的啤酒厂。你可以指定要获取的随机啤酒厂数量（1-10）。

📋 list_brewery_types

获取所有可用啤酒厂类型的完整列表及其说明。

用法

开发

使用 MCP Inspector 进行开发（推荐）：

npm run dev

此命令会通过 MCP Inspector 启动服务，它提供：

• 🔍 对所有 MCP 工具进行交互式测试
• 📊 对服务响应进行实时调试
• 🎯 通过基于 Web 的界面可视化探索工具
• 🚀 即时反馈，无需配置完整的 MCP 客户端

Inspector 会自动在浏览器中打开，你可以实时测试啤酒厂搜索、探索随机啤酒厂并验证所有功能。

监视更改并重新构建（生产模式）：

npm run watch

API 示例

搜索波特兰的啤酒厂

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

获取特定啤酒厂

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

获取 3 家随机啤酒厂

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

数据架构

每个啤酒厂对象包含以下信息：

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

速率限制

Open Brewery DB 的速率限制较为合理：

• 基本使用无需身份验证
• 请合理调用 API
• 若使用量较大，请考虑缓存响应

参与贡献

欢迎贡献！欢迎提交 Pull Request。对于重大更改，请先提出 issue，讨论你希望进行的更改。

开发环境设置

1. Fork 此代码库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 进行更改
4. 运行测试：npm test
5. 提交更改（git commit -m 'feat: Add some amazing feature'）
6. 推送到该分支（git push origin feature/amazing-feature）
7. 提出 Pull Request

啤酒厂数据贡献

想帮助改进啤酒厂数据吗？
欢迎为啤酒厂列表和数据做出贡献！请查看 Open Brewery DB GitHub 代码库，提出更改建议、添加新的啤酒厂，或协助维护数据集。

许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。

致谢

• 感谢 Open Brewery DB 提供出色的啤酒厂 API
• 感谢 Model Context Protocol 提供协议规范
• 感谢所有为啤酒厂数据做出贡献的人

支持

如果你遇到问题或有疑问：

1. 查看 Open Brewery DB 文档
2. 在此代码库中提出 issue
3. 查看现有 issue，寻找类似问题

---

注意：这是一个非官方的 Open Brewery DB MCP 服务，与 Open Brewery DB 没有隶属关系，也未获其认可。