酿造数据API服务

一个连接BrewFather与LLM工具的MCP服务器,提供批量查询、详细酿造数据检索和酿造计算功能。

  • by jmstone617
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 jmstone617/brewfather-mcp

使用说明

🍺 BrewFather MCP服务器

将BrewFather连接到LLM工具的MCP服务器,通过简单的API实现批量查找、详细的酿造数据检索和酿造计算。

✨ 特性

  • 批量检索: 列出最近的酿造批次及其排序和限制(get_batch)。
  • 深潜: 检索特定批次的完整配方、发酵和重力细节(get_batch_details)。
  • 计算器: 内置的实用程序,如ABV计算(calculate_ABV)。
  • 类型安全: 使用TypeScript和Zod构建,用于强大的模式验证。

🛠️ 先决条件

  • Node.js(v18或更高版本)
  • A. 酿酒师 具有API访问权限的帐户(需要高级订阅)。

🚀 安装

  1. 克隆存储库:
git clone https://github.com/yourusername/brewfather-mcp.git
cd brewfather-mcp
  1. 安装依赖项:
npm install

⚙️ 配置

在根目录中创建.env文件并添加您的BrewFather凭据:

BREWFATHER_USER_ID=your_user_id
BREWFATHER_API_KEY=your_api_key

🏃 用法

开发(MCP检查员)

要使用MCP检查器在本地测试服务器功能:

npx @modelcontextprotocol/inspector npx tsx src/index.ts

集成(克劳德桌面/LLM)

将服务器添加到配置文件中:

{
  "mcpServers": {
    "brewfather": {
      "command": "npx",
      "args": ["-y", "tsx", "/path/to/brewfather-mcp/src/index.ts"],
      "env": {
        "BREWFATHER_USER_ID": "your_user_id",
        "BREWFATHER_API_KEY": "your_api_key"
      }
    }
  }
}