rogertheunissenmerge-oss

@sommelierx/mcp-server

AI アシスタント向けのワインペアリングインテリジェンスです。Claude、Cursor、Windsurf、または MCP 対応クライアントをソムリエ品質のペアリングアルゴリズムに接続し、食材、料理、レシピに合うワインを見つけます。

クイックスタート

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "sommelierx": {
      "command": "npx",
      "args": ["@sommelierx/mcp-server"]
    }
  }
}

これで完了です。Claude に 「グリルサーモンに合うワインは？」 と尋ねると、SommelierX を使って回答します。

Pro API キーを使う場合

レシピの抽出、グループペアリング、スコアの内訳を利用できます。

{
  "mcpServers": {
    "sommelierx": {
      "command": "npx",
      "args": ["@sommelierx/mcp-server"],
      "env": {
        "SOMMELIERX_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cursor / Windsurf / その他の MCP クライアント

同じ設定を使用できます。クライアントの MCP 設定に command と args を追加します。

利用可能なツール

ツール	機能	プラン
pair_wine_with_ingredients	食材のリスト（例：「サーモン、レモン、ディル」）に合うワインを検索します	無料
pair_wine_with_meal	料理名（例：「risotto ai funghi」）に合うワインを検索します	無料
find_meals_for_wine	ワインのスタイル（例：「Barolo」）に合う料理を検索します	無料
search_ingredients	食材データベースを検索します	無料
search_meals	料理データベースを検索します	無料
pair_wine_with_recipe_url	レシピ URL から食材を抽出し、ワインを提案します	Pro
group_pairing	複数の料理（例：3 コースディナー）に合う最適なワインを検索します	Pro

認証

SommelierX は 2 種類の認証方法に対応しています。どちらか一方を使用できます。両方を設定する必要はありません。

オプション 1：API キー（サブスクリプション）

MCP クライアントの設定で SOMMELIERX_API_KEY 環境変数を設定します。キーの形式は sk_live_... です。プラン（Free / Pro / Enterprise）に応じて、毎月の呼び出し回数が割り当てられます。

{
  "mcpServers": {
    "sommelierx": {
      "command": "npx",
      "args": ["@sommelierx/mcp-server"],
      "env": {
        "SOMMELIERX_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

api.sommelierx.com で API キーを取得してください。

オプション 2：x402 決済（呼び出しごとの支払い）

API キーは不要です。Coinbase x402 プロトコルを介して、Base ネットワーク上の USDC で AI エージェントが呼び出しごとに支払います。API キーなしでリクエストすると、サーバーは支払いペイロードを含む 402 Payment Required レスポンスを返します。x402 対応エージェントはこれを自動的に処理します。

次のような場合に最適です。

• 自身のウォレットを管理する AI エージェント
• サブスクリプションなしの従量課金制
• エージェント間の商取引（人間が介在しない）

料金（呼び出しごと）

ツール	料金	プラン
pair_wine_with_meal	$0.01	無料
find_meals_for_wine	$0.01	無料
search_ingredients	$0.005	無料
search_meals	$0.005	無料
pair_wine_with_ingredients	$0.02	Pro
pair_wine_with_recipe_url	$0.02	Pro
group_pairing	$0.03	Pro

API キーを使用する場合、呼び出し回数はプランの上限から差し引かれます。x402 を使用する場合、呼び出しごとに記載の料金が請求されます。

会話例

基本的なペアリング：

「サーモン、アスパラガス、オランデーズソースによく合うワインは？」

ワインから料理を提案：

「バローロを一本持っています。何を料理したらいいですか？」

レシピ URL：

「このレシピに合うワインは？ https://www.allrecipes.com/recipe/...」

ディナーパーティー：

「3 コースディナーを計画しています。シーザーサラダ、ラムラック、チョコレートムースに合うワインを 1 本選ぶとしたら？」

仕組み

1. AI アシスタントにワインについて質問します
2. アシスタントが適切な SommelierX ツールを呼び出します
3. MCP サーバーが入力を構造化された API 呼び出しに変換します
4. SommelierX のペアリングアルゴリズム（料理の DNA 17 次元 × ワインの DNA 19 次元）が相性を計算します
5. ソムリエの実際の専門知識に基づいてスコア化されたワインのおすすめが表示されます

食材の解決

pair_wine_with_ingredients を使用すると、サーバーが自然言語の食材名をデータベースの項目に自動的に対応付けます。AI アシスタントがデータベース ID を知っている必要はありません。食材名をそのまま渡せます。

設定

環境変数	必須	デフォルト	説明
SOMMELIERX_API_KEY	いいえ	--	Pro／Enterprise アクセス用の API キーです。キーがない場合は、無料プラン（1 日あたり 50 回）を利用できます。
SOMMELIERX_API_URL	いいえ	https://api.sommelierx.com	API のベース URL です。
SOMMELIERX_LANGUAGE	いいえ	en	結果のデフォルト言語（en、nl、fr、de、es、it）です。

API プラン

プラン	1 日あたりの上限	1 分あたりの上限	機能
Free	50 回	2 回／分	基本的なペアリング、検索、食材／料理の照会
Pro ($49/mo)	500 回	20 回／分	＋ レシピ URL の抽出、グループのペアリング、スコアの内訳
Enterprise	10,000 回	100 回／分	＋ カスタム上限、SLA

API キーは api.sommelierx.com で取得できます。

API ドキュメント

API ドキュメントの全文は docs.sommelierx.com でご覧いただけます。

OpenAPI 仕様は https://api.sommelierx.com/api/v1/openapi.json で提供されています。

開発

npm install
npm run build
npm run dev       # development mode with hot reload
npm run typecheck # type checking without emit

要件

• Node.js >= 18.0.0

ライセンス

MIT