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 が起動します。これは、すべての醸造所ツールをインタラクティブにテストしたり、調べたりできるウェブベースのインターフェースです。

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 も引き続き micro brewery と見なされます
• 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 Inspector では次のことができます。

• 🔍 すべての MCP ツールをインタラクティブにテスト
• 📊 サーバーの応答をリアルタイムでデバッグ
• 🎯 ウェブベースのインターフェースでツールを視覚的に確認
• 🚀 MCP クライアントをひととおり設定せずにすぐにフィードバックを取得

Inspector はブラウザーで自動的に開き、醸造所の検索、ランダムな醸造所の確認、すべての機能のリアルタイム検証ができます。

変更を監視して再ビルドするには（本番モード）：

npm run watch

API の例

Portland の醸造所を検索

{
  "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 呼び出しは節度を持って行ってください
• 大量に使用する場合は、レスポンスのキャッシュをご検討ください

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。大きな変更の場合は、まずイシューを作成して、変更したい内容について話し合ってください。

開発環境のセットアップ

1. リポジトリをフォークします
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. プルリクエストを作成します

醸造所データへの貢献

醸造所データそのものの改善に協力しませんか？
醸造所の一覧やデータへの貢献を歓迎します！Open Brewery DB GitHub リポジトリを確認して、変更を提案したり、新しい醸造所を追加したり、データセットの維持に協力したりしてください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細はLICENSEファイルをご覧ください。

謝辞

• 優れた醸造所 API を提供しているOpen Brewery DB
• プロトコル仕様を提供しているModel Context Protocol
• 醸造所データへのすべての貢献者

サポート

問題が発生した場合や質問がある場合は、次の方法をご利用ください。

1. Open Brewery DB ドキュメントを確認します
2. このリポジトリでイシューを作成します
3. 同様の問題について、既存のイシューを確認します

---

注：これは Open Brewery DB 用の非公式 MCP サーバーです。Open Brewery DB との提携関係はなく、同組織から承認を受けているものでもありません。