# Cocktail MCP Server

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

## セットアップ

```bash
npm install
npm run build
```

## Claude Desktop接続設定

`claude_desktop_config.json` に以下を追加:

```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...
```

## 開発

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

## 技術スタック

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