VanAuto Campers

VanAuto Campers MCP

AI クライアントが VanAuto のキャンピングカーの出品、レンタル、マーケットプレイス（akcesoria）の商品を検索・閲覧できる読み取り専用の MCP サーバーです。公開されている VanAuto API と通信するため、認証情報は不要で、データを変更することもできません。

公開エンドポイント： https://mcp.vanauto.pl/mcp（Streamable HTTP、認証なし） ヘルスチェック： https://mcp.vanauto.pl/health（GitHub Actions 経由で 6 時間ごとに稼働状況を確認） MCP Registry： pl.vanauto/campers — レジストリに接続されたクライアントから検出できます。

ツール

ツール	機能
search_campers	テキスト、メーカー、モデル、キャンピングカーのタイプ、燃料、ギアボックス、状態、価格、年式、走行距離、就寝人数、都市で絞り込み、販売中またはレンタル中の出品を検索します。レンタルでは利用可能日でも絞り込めます。
get_camper_details	スラッグで指定した出品（販売かレンタルかを自動判定）の詳細、または cam_... ID で指定したキャンピングカーの仕様書を取得します。デコード済みの仕様、写真、装備、連絡先、リンクが含まれます。includePhotos を指定すると、400px のサムネイルを実画像として添付するため、マルチモーダルモデルで確認できます。
analyze_camper_prices	対象グループの市場価格統計（最小値／最大値／平均値／中央値／p25／p75、年式別平均）を取得し、必要に応じて出品 1 件が市場でどの位置にあるか（パーセンタイル、中央値からの差）を示します。
find_similar_campers	販売中の出品に対してプラットフォームが提案する代替候補を検索します。
list_camper_makes	ブランド名の特定に使える、販売・レンタル中の件数付きキャンピングカーメーカー 200 社以上の一覧を取得します。
list_camper_equipment	カテゴリ別にまとめた装備カタログを取得します。
get_camper_market_stats	現在のスナップショットを取得します。販売中の出品数、ボディタイプ別のキャンピングカー数、在庫のあるメーカーが含まれます。
get_rental_reviews	レンタル出品に寄せられた公開済みのカスタマーレビューを取得します。
search_marketplace_listings	テキスト、メーカー、カテゴリ、状態、適合性、価格、場所で絞り込み、マーケットプレイスのアクセサリーを検索します。
get_marketplace_listing_details	出品者情報、配送、写真、関連商品を含むアクセサリー出品の詳細を取得します。
get_marketplace_seller	信頼バッジ、評価、評判、販売中の商品を含む出品者プロフィールを取得します。
search_wanted_ads	マーケットプレイスの購入希望広告（部品やアクセサリーを探している購入者）を検索します。

プロンプト

MCP プロンプトに対応したクライアントでは、ワンクリックで次の操作を実行できます。

プロンプト	機能
social-post	出品情報を取得し、ハッシュタグ付きのポーランド語の Facebook／Instagram／OLX 投稿文を作成します。
price-check	出品を同じ市場グループと比較し、価格についてポーランド語で評価します。
compare-campers	購入者のニーズに照らして、2～4 件の出品を並べて比較します。
seo-description	出品説明文を SEO に適したポーランド語の文章に書き換えます。

データはサイトと同じくポーランド語で提供され、価格の通貨は PLN です。レンタルの各行には単一価格ではなく、dailyRates（期間ごとの料金）が含まれます。

クライアントの接続

リモート（ホスト型）

OpenCode（~/.config/opencode/opencode.json）：

{
  "mcp": {
    "vanauto-campers": {
      "type": "remote",
      "url": "https://mcp.vanauto.pl/mcp",
      "enabled": true
    }
  }
}

Claude／ChatGPT：https://mcp.vanauto.pl/mcp をカスタムコネクターとして追加します。

Claude Desktop（ネイティブのリモート接続に対応していない旧ビルド）：

{
  "mcpServers": {
    "vanauto-campers": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.vanauto.pl/mcp"]
    }
  }
}

ローカル（stdio）

パッケージは vanauto-mcp-campers として npm で利用できるよう準備されています。公開後は次のようにします。

npx -y vanauto-mcp-campers

公開までは、チェックアウトしたプロジェクトから src/server.js の絶対パスを指定して実行します（mcp.config.example.json を参照）：

{
  "mcpServers": {
    "vanauto-campers": {
      "command": "node",
      "args": ["/path/to/mcp-campers/src/server.js"],
      "env": {
        "VANAUTO_API_URL": "https://api.vanauto.pl",
        "VANAUTO_SITE_URL": "https://vanauto.pl"
      }
    }
  }
}

設定

環境変数	デフォルト	用途
VANAUTO_API_URL	https://api.vanauto.pl	API のベース URL です。ローカルの Rails サーバーを使うには http://localhost:3000 を指定します。
VANAUTO_SITE_URL	https://vanauto.pl	出品リンクの作成に使うフロントエンドのベース URL です。

開発

npm install
npm start            # stdio server
npm run dev          # local HTTP endpoint at http://127.0.0.1:8787/mcp (wrangler dev)

チェック

npm run check            # syntax check
npm run smoke            # live tool checks against the configured API
npm run smoke:protocol   # MCP handshake + tools/list + tools/call over stdio
npm run smoke:http       # same over HTTP: MCP_URL=https://mcp.vanauto.pl/mcp npm run smoke:http
npm run usage:report     # anonymous tool-usage report from D1 (last 30 days)

デプロイ

サーバーは Cloudflare Worker（src/worker.js）として実行されます。stdio エントリ（src/server.js）はローカルクライアント用です。どちらも src/app.js にある同じツールファクトリーを使用します。

npx wrangler login       # once per machine
npx wrangler deploy      # deploys the Worker + mcp.vanauto.pl custom domain

main へのプッシュは .github/workflows/deploy.yml を介して自動的にデプロイされます。このワークフローには、次の 2 つのリポジトリシークレットが必要です。

シークレット	値
CLOUDFLARE_API_TOKEN	Edit Cloudflare Workers テンプレートを使用した API トークン
CLOUDFLARE_ACCOUNT_ID	Cloudflare アカウント ID（Workers ダッシュボードの右サイドバー）

ワークフローは各デプロイ後に https://mcp.vanauto.pl/mcp に対して npm run smoke:http を実行します。

MCP レジストリ

このサーバーは、公式 MCP レジストリに pl.vanauto/campers として公開されています（vanauto.pl の DNS TXT レコードによって名前空間を検証済み）。server.json を変更した後、新しいバージョンを公開するには、次のコマンドを実行します。

# Signing key lives outside the repo, e.g. ~/.config/vanauto-mcp/registry-key.pem
PRIVATE_KEY="$(openssl pkey -in ~/.config/vanauto-mcp/registry-key.pem -noout -text | grep -A3 'priv:' | tail -n +2 | tr -d ' :\n')"
mcp-publisher login dns --domain vanauto.pl --private-key "$PRIVATE_KEY"
mcp-publisher publish

server.json の version は package.json と同期させてください。レジストリは重複するバージョンを拒否します。

利用状況の分析

デプロイ済みの Worker は、ツール呼び出しごとに匿名の行を 1 件、Cloudflare D1（tool_events）に書き込みます。記録されるのは、ツール名、サニタイズおよび切り詰め済みの引数、成功／エラー、実行時間、ユーザーエージェントから解析した大まかなクライアント種別（chatgpt、claude、opencode など）です。IP アドレス、トークン、ユーザー識別子は保存されません。

npm run usage:report             # last 30 days
npm run usage:report -- --days 7

レポートには、ツールごとの呼び出し数、クライアント種別、レンタルと販売の検索、よくリクエストされるフレーズ、メーカー、キャンピングカーの種類が表示されます。購入者が AI に何を尋ねているかを把握するための、市場の参考情報として活用できます。ローカルでは、wrangler dev は本番データベースではなくローカルデータベースにイベントを書き込みます。

動作に関する注意事項

• 読み取り専用です。 すべての呼び出しは /public/... に対する HTTP GET です。データベースへのアクセスも認証トークンもありません。
• 公開エンドポイントは 1 つだけです。 MCP を提供するのは mcp.vanauto.pl のみです。workers.dev のルートは無効化されており、ゾーンのレート制限ルールを回避できません。
• キャッシュ。 カタログのエンドポイント（メーカー、装備）はプロセス内で 1 時間、検索と詳細は 2 分間キャッシュされます。API 自体もレスポンスをキャッシュします。Workers では、各アイソレートが独自の短期間有効なキャッシュインスタンスを持ちます。
• ページネーション。 search_campers は最大 50 件の行と nextCursor を返します。次のページを取得するには、これを after として渡してください。マーケットプレイス検索はページ単位です（page、perPage）。
• 切り詰め。 長い掲載説明文は切り詰められます（デフォルトは 4000 文字。変更するには maxDescriptionChars を指定します）。これにより、1 回の呼び出しでモデルのコンテキストがあふれるのを防ぎます。
• 写真。 写真の URL は常に含まれます。includePhotos を指定すると、最大 6 枚（デフォルトは 3 枚）の 400px WebP サムネイル（各約 25 KB）が、マルチモーダルモデル向けの MCP 画像コンテンツとして追加されます。
• ツールの失敗は、読みやすいメッセージを含む isError 結果として返されます。たとえば、スラッグが見つからない場合は「No active sale or rental listing found with slug ...」と報告されます。