Cocktail MCP Server

TheCocktailDB APIを利用したMCPサーバー。Claude Desktopに接続すると、自然言語でカクテルのレシピ検索・材料情報の取得ができるようになります。

セットアップ

npm install
npm run build

Claude Desktop接続設定

claude_desktop_config.json に以下を追加:

{
  "mcpServers": {
    "cocktail": {
      "command": "node",
      "args": ["/path/to/cocktail-mcp-server/dist/index.js"]
    }
  }
}

ツール一覧

ツール名	説明	引数
search_cocktail	カクテル名でレシピ検索	name: string
search_by_ingredient	材料からカクテル逆引き	ingredient: string
get_random_cocktail	ランダムにカクテルを1杯おすすめ	なし
get_ingredient_info	材料の詳細情報を取得	ingredient: string
filter_cocktails	カテゴリ/アルコール有無でフィルタ	filter_type: "category" | "alcoholic", value: string

会話例

ユーザー: モヒートの作り方教えて
Claude: モヒートのレシピですね！
  【材料】ライトラム 2-3 oz、ライムジュース 1 oz、砂糖 2 tsp、ミント...

ユーザー: ウォッカで作れるカクテル何がある？
Claude: ウォッカを使ったカクテルはこちらです！
  1. Moscow Mule  2. Vodka Martini  3. Cosmopolitan...

ユーザー: 今日のおすすめカクテル出して
Claude: こんなのはいかがですか？ Old Fashioned...

開発

npm test            # テスト実行
npm run test:watch  # ウォッチモード

技術スタック

• TypeScript / Node.js
• @modelcontextprotocol/sdk (MCP SDK)
• Zod（バリデーション）
• Vitest（テスト）
• TheCocktailDB API（テストAPIキー "1"）