Cellarion

cellarion-mcp

AI をワインセラーにつなぎましょう。これは Cellarion 用の MCP ブリッジです。stdio ベースの MCP クライアント（Claude Desktop、Cursor、…）から Cellarion アカウントに接続できるため、アシスタントに次のようなことを尋ねられます。

• 「飲み頃を過ぎる前に、今夜開けるならどれがいいですか？」
• 「Barolo はまだありますか？　どこに保管されていますか？」
• 「先月飲んだワインと、その評価を教えてください」

このブリッジは お使いの マシン上でのみ動作し、個人用の取り消し可能な API トークンを使って、Cellarion サーバーの /api/mcp エンドポイントにリクエストを中継します。ツールとリソースはサーバーが定義するため、Cellarion を更新すれば AI ができることも自動的に更新されます。このブリッジがそれを把握する必要はありません。

セットアップ

1. Cellarion でトークンを作成します。設定 → API トークン に移動し、read スコープのトークンを作成します。表示された cel_… の値をコピーしてください（値が表示されるのは一度だけです）。
2. サーバーをクライアントに追加します。Claude Desktop（claude_desktop_config.json）の場合：

{
  "mcpServers": {
    "cellarion": {
      "command": "npx",
      "args": ["-y", "cellarion-mcp"],
      "env": {
        "CELLARION_TOKEN": "cel_your_token_here"
      }
    }
  }
}

3. クライアントを再起動します。セラーについて尋ねてみましょう。

Cellarion をセルフホストしていますか？ ブリッジの接続先をお使いのインスタンスに設定します。

      "env": {
        "CELLARION_TOKEN": "cel_your_token_here",
        "CELLARION_URL": "https://cellarion.your-domain.example"
      }

（コマンドライン引数の --token ／ --url も使用できます。）

セキュリティに関する注意事項

• トークンにはスコープが設定されており、Cellarion から即座に取り消せます。取り消すと、このブリッジはセッションの途中でも切断されます。
• read スコープのトークンで読み取れるのは、ご自身のセラーのデータだけです。データの変更、他のアカウントの読み取り、トークンの管理はできません。
• トークンの送信先は CELLARION_URL のホストだけです。他の場所には送信されません。ログにも記録されません。
• リクエストの途中で接続が切れた場合、ブリッジは再接続します。ツールとリソースの一覧を再取得し、サーバーが読み取り専用として一覧に掲載しているツールの呼び出しも再実行します。セラーを変更する可能性のあるその他のツールは、idempotency_key が含まれている場合に限り再送されます。その場合、サーバーは二重に処理せず、最初の結果を返します。それ以外の場合、AI にはエラーが返されるため、再試行の前に何が起きたか確認できます。ブリッジのセッションが期限切れだったためにサーバーが拒否したリクエストは実行されていません。そのため、ブリッジは新しいセッションを開き、リクエストを再送します。

ライセンス

Cellarion 本体と同じく AGPL-3.0 です。ソースコード：https://github.com/jagduvi1/Cellarion（cellarion-mcp/）。