啤酒厂数据库MCP服务

一个连接AI助手与Open Brewery DB的MCP服务器,支持搜索啤酒厂、按城市查找、随机发现及类型过滤功能。

  • by giridhar7889
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 giridhar7889/Brewery-mcp-server

使用说明

打开啤酒厂MCP服务器

一个模型上下文协议(MCP)服务器,将您的AI助手连接到 开放啤酒厂数据库。这允许您的助手搜索啤酒厂,按城市查找地点,发现随机的啤酒厂,并按类型(微型、啤酒厂等)进行过滤。

项目结构

brewery-mcp/
├── src/
│   ├── server.py       # The MCP server entry point (handles JSON-RPC over stdio)
│   └── brewery.py      # Service layer interacting with Open Brewery DB API
├── requirements.txt    # Python dependencies
└── README.md           # This file

设置和安装

先决条件

  • Python 3.9+
  • pip

1.安装依赖项

cd brewery-mcp
pip install -r requirements.txt

2.运行服务器

服务器使用 stdio 用于通信,这意味着它被设计为由MCP客户端(如Claude Desktop)直接运行。

要手动测试或运行它:

python src/server.py

(它将等待stdin上的JSON输入。您可以键入手动JSON-RPC命令进行测试。)

3.在Claude Desktop中配置

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "brewery": {
      "command": "python",
      "args": ["/absolute/path/to/brewery-mcp/src/server.py"]
    }
  }
}

为什么是这个服务器?

我选择了 开放啤酒厂数据库 因为它完美地代表了MCP的值:

  1. 探索:它将静态数据库转换为交互式发现工具。你可以问“在圣地亚哥给我找一家小啤酒厂”或“计划在奥斯汀参观一次啤酒厂”,而不仅仅是“搜索”
  2. 简洁:它不需要身份验证密钥,因此易于共享和立即运行。
  3. 现实世界的实用程序:它帮助用户找到当地企业并计划社交活动,提供超越抽象数据处理的有形价值。

演示和功能

功能(工具)

  • search_breweries(query):按名称搜索(例如,“Stone Brewing”)。
  • get_breweries_by_city(city):列出一个城市的所有啤酒厂。
  • get_random_brewery():返回随机发现。
  • filter_breweries_by_type(type_name, city):按特定类型缩小范围,如“微型”、“啤酒屋”或“区域”。

示例提示

用户:

“我计划去波特兰旅行。你能在那里给我找一些微型啤酒厂吗?另外,给我看一个随机的啤酒厂,只是为了好玩。”

MCP客户端(幕后):

  1. 呼叫 filter_breweries_by_type(type_name="micro", city="Portland").
  2. 呼叫 get_random_brewery().

答复:

“以下是波特兰的一些微型啤酒厂:

  1. Away Days酿酒公司。 -东南第十大道1516号
  2. Baerlic酿酒公司 -东南11大道2235号 ...

对于你的随机发现: 黄泉啤酒厂 俄亥俄州黄泉!这是一家微型啤酒厂,其网站位于yellowspringsbrewery.com。”