Bar Assistant MCP Server

酒吧助理MCP服务器

MCP（模型上下文协议）服务器 酒吧助理 -管理你的家庭酒吧货架，发现你可以制作的鸡尾酒。

特性

• 📋 查看酒吧货架上的食材
• 🍸 看看你可以用你的东西做的鸡尾酒
• ➕ 将配料添加到货架上
• ➖ 从架子上取下配料
• 🔍 按名称搜索配料
• 🏪 发现您可用的酒吧
• 🧪 创造新的成分
• 🍹 创建新的鸡尾酒食谱
• ✏️ 更新现有鸡尾酒配方

安装

使用uvx（推荐）

直接用uvx运行：

uvx --from git+https://github.com/the-real-py/bar-assistant-mcp bar-assistant-mcp \
  https://bar.johnprovost.com/bar/api \
  your_token_here \
  1

或者在中设置环境变量 .env 并运行：

uvx --from git+https://github.com/the-real-py/bar-assistant-mcp bar-assistant-mcp

使用pip

pip install git+https://github.com/the-real-py/bar-assistant-mcp
bar-assistant-mcp

配置

创建一个 .env 项目目录中的文件：

BAR_ASSISTANT_API_URL=https://bar.johnprovost.com/bar/api
BAR_ASSISTANT_TOKEN=your_bearer_token_here
BAR_ASSISTANT_BAR_ID=1

或者将它们作为命令行参数传递：

bar-assistant-mcp   

获取您的凭据

1. API URL：您的Bar Assistant实例URL+API路径

- 标准设置： http://localhost:8000/api - 自定义设置：检查您的反向代理配置（例如。， https://bar.example.com/bar/api)

1. 代币：从您的酒吧助理配置文件设置生成个人访问令牌
2. 酒吧ID：使用 list_bars 工具来查找您的酒吧ID，或者通常 1 你的第一家酒吧

重要：The BAR_ASSISTANT_BAR_ID 是可选的。如果你不设置它，你可以提供 bar_id 调用工具时使用参数，或使用 list_bars 工具首先发现您可用的酒吧。

使用Claude Desktop

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "bar-assistant": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/the-real-py/bar-assistant-mcp",
        "bar-assistant-mcp",
        "https://bar.johnprovost.com/bar/api",
        "your_token_here",
        "1"
      ]
    }
  }
}

或者使用环境变量：

{
  "mcpServers": {
    "bar-assistant": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/the-real-py/bar-assistant-mcp",
        "bar-assistant-mcp"
      ],
      "env": {
        "BAR_ASSISTANT_API_URL": "https://bar.johnprovost.com/bar/api",
        "BAR_ASSISTANT_TOKEN": "your_token_here",
        "BAR_ASSISTANT_BAR_ID": "1"
      }
    }
  }
}

可用工具

list_bars

发现您可以访问的所有酒吧并获取其ID。

get_shelf_ingredients

列出酒吧货架上的所有配料。

参数：

• bar_id （可选）：要查询的栏ID
• page （可选）：分页页码

get_shelf_cocktails

查看您可以用当前食材制作的所有鸡尾酒。

参数：

• bar_id （可选）：要查询的栏ID
• page （可选）：分页页码

add_ingredients_to_shelf

按ID将配料添加到货架上。

参数：

• ingredient_ids （必填）：成分ID数组
• bar_id （可选）：要更新的栏ID

remove_ingredients_from_shelf

从架子上取下配料。

参数：

• ingredient_ids （必填）：成分ID数组
• bar_id （可选）：要更新的栏ID

search_ingredients

按名称搜索成分以查找其ID。

参数：

• name （必填）：要搜索的成分名称
• bar_id （可选）：栏ID上下文

create_ingredient

在酒吧数据库中创建新的配料。当一种成分不存在，需要在添加到鸡尾酒中之前创建时，请使用此功能。

参数：

• name （必填）：成分名称
• strength （可选）：酒精浓度/百分比（例如，40%ABV为40）
• description （可选）：成分说明
• origin （可选）：成分的原产地/国家
• color （可选）：十六进制颜色代码（例如“#ffffff”）
• parent_ingredient_id （可选）：用于分类的父成分ID
• units （可选）：此成分的默认单位（例如，“ml”、“oz”、“dash”）
• bar_id （可选）：栏ID上下文

create_cocktail

创建一个新的鸡尾酒配方。先用 search_ingredients 要查找成分ID，请使用 create_ingredient 对于任何缺失的成分。

参数：

• name （必填）：鸡尾酒名称
• instructions （必填）：制作鸡尾酒的分步说明
• ingredients （必填）：包含以下成分的数组：

- ingredient_id （必填）：成分ID - amount （必填）：配料量 - units （可选）：数量单位（例如，“ml”、“oz”、“dash”） - optional （可选）：此成分是否可选 - note （可选）：此成分的附加说明 - sort （可选）：成分的排序顺序

• description （可选）：鸡尾酒描述
• garnish （可选）：装饰鸡尾酒
• source （可选）：食谱的来源/产地
• glass_id （可选）：要使用的玻璃类型的ID
• method_id （可选）：混合方法的ID（摇动、搅拌等）
• tags （可选）：鸡尾酒标签数组
• bar_id （可选）：栏ID上下文

示例-制作玛格丽塔酒：

1. search_ingredients(name="tequila") → ID: 45
2. search_ingredients(name="lime juice") → ID: 89  
3. search_ingredients(name="triple sec") → ID: 23
4. create_cocktail(
     name="Margarita",
     instructions="1. Add all ingredients to shaker with ice\n2. Shake well\n3. Strain into salt-rimmed glass",
     ingredients=[
       {"ingredient_id": 45, "amount": 60, "units": "ml"},
       {"ingredient_id": 89, "amount": 30, "units": "ml"},
       {"ingredient_id": 23, "amount": 30, "units": "ml"}
     ],
     garnish="Lime wheel, salt rim"
   )

update_cocktail

更新现有的鸡尾酒配方。使用此选项可以修改鸡尾酒的名称、说明、成分或其他细节。

参数：

• id （必填）：要更新的鸡尾酒ID
• name （必填）：鸡尾酒名称
• instructions （必填）：制作鸡尾酒的分步说明
• ingredients （必填）：包含以下成分的数组：

- ingredient_id （必填）：成分ID - amount （必填）：配料量 - units （可选）：数量单位（例如，“ml”、“oz”、“dash”） - optional （可选）：此成分是否可选 - note （可选）：此成分的附加说明 - sort （可选）：成分的排序顺序

• description （可选）：鸡尾酒描述
• garnish （可选）：装饰鸡尾酒
• source （可选）：食谱的来源/产地
• glass_id （可选）：要使用的玻璃类型的ID
• method_id （可选）：混合方法的ID（摇动、搅拌等）
• tags （可选）：鸡尾酒标签数组
• bar_id （可选）：栏ID上下文

资源

• bar://shelf/ingredients -您的酒吧货架配料
• bar://shelf/cocktails -你可以做的鸡尾酒

发展

在开发模式下克隆和安装：

git clone https://github.com/the-real-py/bar-assistant-mcp
cd bar-assistant-mcp
pip install -e .

故障排除

查找您的API URL

Bar Assistant API URL取决于您的设置：

1. 标准Docker设置: http://localhost:8000/api
2. 自定义反向代理：检查API路由的nginx/Traefik配置
3. 云托管：通常由您的托管服务提供

若要验证API URL是否正确，请运行：

curl -H "Accept: application/json" YOUR_API_URL/server/version

您应该得到一个包含版本信息的JSON响应。

许可证

麻省理工学院

链接

• 酒吧助理
• 酒吧助理文件
• MCP文件