VanAuto Campers

pl.vanautov0.3.1更新於 Oct 6, 2026

Search VanAuto camper and rental listings: specs, photos, prices, equipment, contacts.

已驗證Streamable HTTP可網頁執行Web Search & ScrapingBusiness & Commerce

概覽

AI 產生的概覽

讓助理透過公開的波蘭語 API 搜尋 VanAuto 露營車出售與租賃物件、市場配件以及價格統計。

功能
此伺服器透過公開的 VanAuto API 提供唯讀工具：search_campers 可依文字、品牌、型號、類型、燃料、變速箱、價格、年份、里程、睡眠人數與城市篩選在售或在租物件；get_camper_details 回傳單一物件的規格、照片、裝備與聯絡方式；analyze_camper_prices 與 get_camper_market_stats 提供市場統計；find_similar_campers、list_camper_makes 與 list_camper_equipment 用於瀏覽。市場工具涵蓋配件物件、賣家與徵求廣告，get_rental_reviews 回傳已發布的租賃評價。提示詞可產生波蘭語社群貼文、價格評估、比較與 SEO 描述。
適用情境
適合需要查詢露營車或租賃物件、將價格與同類市場比較，或搜尋市場配件與徵求廣告的情境。適用於購車研究、物件比較以及波蘭語物件內容產生。
執行需求
可使用無需驗證的遠端 Streamable HTTP 端點 Node.js stdio 伺服器。本機執行可選用 VANAUTO_API_URL 與 VANAUTO_SITE_URL 環境變數。不需要帳號或 API 金鑰。
安裝前請注意
唯讀：所有呼叫皆為 HTTP GET，不會變更資料。物件資料為波蘭語，價格以 PLN 計價。使用 includePhotos 要求的照片縮圖會從平台取得並以圖像內容傳給模型。公開端點不要求任何憑證。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 VanAuto Campers，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "campers": {
      "type": "http",
      "url": "https://mcp.vanauto.pl/mcp"
    }
  }
}

README

VanAuto Campers MCP

Read-only MCP server that lets an AI client search and view VanAuto camper listings, rentals and marketplace (akcesoria) offers. It talks to the public VanAuto API, so it needs no credentials and cannot change any data.

Public endpoint: https://mcp.vanauto.pl/mcp (Streamable HTTP, no auth) Health check: https://mcp.vanauto.pl/health (uptime-checked every 6h via GitHub Actions) MCP Registry: pl.vanauto/campers — discoverable by registry-connected clients.

Tools

ToolWhat it does
search_campersSearch active sale or rental listings with filters: text, make, model, camper type, fuel, gearbox, state, price, year, mileage, sleeping places, city; rentals also support availability dates.
get_camper_detailsFull details for one listing by slug (auto-detects sale vs rental) or a camper spec sheet by cam_... id: decoded specs, photos, equipment, contact and links. includePhotos attaches 400px thumbnails as real images so multimodal models can look at them.
analyze_camper_pricesMarket price stats for a cohort (min/max/avg/median/p25/p75, average by year) and, optionally, how one listing compares (percentile, deviation from median).
find_similar_campersAlternatives the platform suggests for a sale listing.
list_camper_makesAll 200+ camper makes with active sale/rental counts, for resolving brand names.
list_camper_equipmentThe equipment catalog grouped by category.
get_camper_market_statsCurrent snapshot: active listing counts, campers by body type, makes with inventory.
get_rental_reviewsPublished customer reviews for a rental listing.
search_marketplace_listingsSearch marketplace accessories with text, manufacturer, category, condition, compatibility, price, location filters.
get_marketplace_listing_detailsFull accessory listing with seller info, shipping, photos, related offers.
get_marketplace_sellerSeller profile: trust badges, ratings, reputation and active offers.
search_wanted_adsMarketplace wanted ads (buyers looking for parts/accessories).

Prompts

Clients that support MCP prompts get one-click flows:

PromptWhat it does
social-postPulls the listing and writes a Polish Facebook/Instagram/OLX post with hashtags.
price-checkCompares a listing against its market cohort and gives a Polish verdict on the price.
compare-campersCompares 2-4 listings side by side against buyer needs.
seo-descriptionRewrites a listing description as an SEO-friendly Polish text.

Data is served in Polish (as on the site); prices are in PLN. Rental rows carry dailyRates (per-period rates) rather than a single price.

Connect a client

Remote (hosted)

OpenCode (~/.config/opencode/opencode.json):

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

Claude / ChatGPT: add https://mcp.vanauto.pl/mcp as a custom connector.

Claude Desktop (older builds without native remote support):

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

Local (stdio)

Use an absolute path to src/server.js (see mcp.config.example.json):

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"      }    }  }}

Configuration

Env varDefaultPurpose
VANAUTO_API_URLhttps://api.vanauto.plAPI base URL. Point at http://localhost:3000 to use a local Rails server.
VANAUTO_SITE_URLhttps://vanauto.plFrontend base URL used to build listing links.

Development

sh
npm installnpm start            # stdio servernpm run dev          # local HTTP endpoint at http://127.0.0.1:8787/mcp (wrangler dev)

Checks

sh
npm run check            # syntax checknpm run smoke            # live tool checks against the configured APInpm run smoke:protocol   # MCP handshake + tools/list + tools/call over stdionpm run smoke:http       # same over HTTP: MCP_URL=https://mcp.vanauto.pl/mcp npm run smoke:http

Deployment

The server runs as a Cloudflare Worker (src/worker.js); the stdio entry (src/server.js) is for local clients. Both share the same tool factory in src/app.js.

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

Pushes to main deploy automatically via .github/workflows/deploy.yml, which needs two repository secrets:

SecretValue
CLOUDFLARE_API_TOKENAPI token with the Edit Cloudflare Workers template
CLOUDFLARE_ACCOUNT_IDCloudflare account id (Workers dashboard, right sidebar)

The workflow runs npm run smoke:http against https://mcp.vanauto.pl/mcp after each deploy.

MCP Registry

The server is published to the official MCP Registry as pl.vanauto/campers (namespace verified via a DNS TXT record on vanauto.pl). To publish a new version after changing server.json:

sh
# Signing key lives outside the repo, e.g. ~/.config/vanauto-mcp/registry-key.pemPRIVATE_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

Keep version in server.json in sync with package.json; the registry rejects duplicate versions.

Behaviour notes

  • Read-only. Every call is an HTTP GET against /public/...; there is no database access and no auth token.
  • One public surface. Only mcp.vanauto.pl serves the MCP; the workers.dev route is disabled so the zone rate-limit rule cannot be bypassed.
  • Caching. Catalog endpoints (makes, equipment) are cached in-process for an hour; searches and details for two minutes. The API itself also caches responses. On Workers, each isolate has its own short-lived instance of that cache.
  • Pagination. search_campers returns up to 50 rows plus a nextCursor; pass it back as after for the next page. Marketplace search is page-based (page, perPage).
  • Truncation. Long listing descriptions are trimmed (default 4000 chars, maxDescriptionChars to change), so one call cannot flood a model's context.
  • Photos. Photo URLs are always included; includePhotos additionally attaches up to 6 (default 3) 400px WebP thumbnails (~25 KB each) as MCP image content for multimodal models.
  • Tool failures come back as isError results with a readable message, e.g. a missing slug reports "No active sale or rental listing found with slug ...".

來源：README.md，提交 4975e55

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.3.1最新Oct 6, 2026