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号 1. Baerlic酿酒公司 -东南11大道2235号 ... 对于你的随机发现： 黄泉啤酒厂 俄亥俄州黄泉！这是一家微型啤酒厂，其网站位于yellowspringsbrewery.com。”

______________________________________________________________________