Openvan.camp Travel Data

@openvancamp/mcp-server

OpenVan.camp 官方 MCP 服务——为 AI Agent 提供免费的、无需身份验证的、机器可读的 vanlife 和房车旅行数据。

通过 Model Context Protocol 提供 30 个只读工具，你可以向 AI 助手询问：

• 完整公路旅行——plan_road_trip 可生成 OpenVan.camp 公路旅行手册：按天规划，包含过夜地点、预算（燃油、过路费、通行贴纸、渡轮）、沿途每个国家的入境和车辆规定，以及可分享的旅行手册页面
• 燃油价格——涵盖所有 API 支持的国家，并使用与 /api/fuel/prices 相同的价格键
• 收费道路——按国家提供每公里费率、通行贴纸、收费桥梁和隧道；以及路线收费估算
• 节假日和交通高峰——公共假日和学校假期（地区级）、官方交通高峰日
• 旅行风险——英国外交、联邦和发展事务部（FCDO）建议等级、GDACS 自然灾害、NASA FIRMS 过去 48 小时内的活跃火情
• 电源插头——插头类型、市电电压和频率、露营地接电连接器（CEE17）
• 海关规定——食品禁令、现金申报、酒类和烟草限额，并附官方引文
• VanSky vanlife 天气适宜度评分（0-100），覆盖国家和城市
• 典型天气（气候）——任意城市或地点在一年中任意一天的天气——ERA5 2021–2025：气温、降水天数、海水温度、太阳辐射、最佳旅行月份
• VanBasket 食品价格指数（世界平均值 = 100）
• 货币兑换（150 多种货币）
• 活动（展览、节庆、聚会、公路旅行）
• 新闻报道，提供 7 种语言
• 签证和边境规定——入境方式、停留时长、天数计算方式、车辆临时进口
• 世界各地的车牌——格式、地区代码、车牌检查，以及车牌图像

每个工具还会返回一张交互式卡片（MCP Apps），Claude 和 ChatGPT 可直接在聊天中呈现：天气卡片展示本周天气最佳和最恶劣的城市；燃油和收费表格带有货币切换功能；签证条款附离境截止日期；活动和新闻轮播，以及完整旅行计划。不支持 MCP Apps 的宿主也能获取相同的文本数据。

数据采用 CC BY 4.0 许可。引用时请注明 OpenVan.camp。

---

安装

Claude 和 ChatGPT（无需安装）

该服务已列入两个目录——打开页面并点击连接：

• Claude：Claude 连接器目录中的 OpenVan.camp
• ChatGPT：ChatGPT 应用目录中的 OpenVan.camp

远程（无需安装，适用于网页客户端）

将兼容 MCP 的宿主连接到托管的 Streamable HTTP 端点：

https://mcp.openvan.camp/mcp

无需身份验证。归属信息会自动添加（?source=mcp-server-sse）。适用于 ChatGPT Apps SDK、基于浏览器的 Agent 和无服务器集成。

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%/Claude/claude_desktop_config.json（Windows）：

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

重启 Claude Desktop。工具应会显示在 🔧 面板中。

Cursor / Windsurf / Continue

添加到 MCP 配置中：

{
  "openvan": {
    "command": "npx",
    "args": ["-y", "@openvancamp/mcp-server"]
  }
}

任意兼容 MCP 的宿主

该服务通过 stdio 使用 MCP。运行：

npx -y @openvancamp/mcp-server

---

工具

工具	描述
plan_road_trip	通过 OpenVan.camp 路书规划 2–10 个地点之间的完整行程：逐日过夜安排、预算、各国入境和车辆规则（申根区 90/180 天）、节假日、安全、电源、检查清单，以及路书链接
get_country_travel_brief	一览某个国家的信息：根据你的护照确定入境和允许停留时间、天气、燃油、道路规则、未来 30 天的节假日、安全、电源插头、海关、食品价格
get_fuel_prices	各国当前零售燃油价格
compare_fuel_prices	比较 2–10 个国家的一种燃油价格
find_cheapest_fuel	按燃油类型列出价格最低（或最高）的国家，可按地区筛选
get_country_travel_weather	某个国家的露营车旅行天气评分（0-100）、太阳能发电量、7 天天气预报
get_city_travel_weather	某个城市或城镇的露营车旅行天气：今天和未来 7 天的天气、在该国城市中的排名、舒适天气日、天气最差的一天、今日评分明细、建议
get_city_climate	某个城市或任意地点在一年中任意一天的典型天气（ERA5 2021–2025）：昼夜温度、35 天内的降水天数、海况、太阳能、VanSky 气候指数、12 个月数据和最佳月份
list_best_weather_countries	列出今天或未来一周旅行天气最佳的前 N 个国家（period=week，按网站排名），可按地区筛选或按温暖程度排序
list_events	Vanlife 活动（展会、节庆、聚会），支持筛选
get_event	查看某个活动的详情（按 slug 查询）
search_stories	Vanlife 新闻：标题、简短摘要，以及 openvan.camp 上的故事页面链接（支持 7 种语言）
compare_food_prices	比较两个国家的食品价格指数
get_country_food_prices	查看某个国家的食品价格指数详情
rank_food_prices	按食品价格列出国家排名（价格最低或最高），可按地区筛选
get_currency_rate	150 多种货币之间的货币换算
check_visa_rules	查询某个护照前往某个目的地的入境规则，并提供可信度和来源
get_route_visa_rules	查询整条路线的签证规则，最多支持 10 本护照，并指出限制最严格的路段
get_vehicle_import_rules	查询外国牌照车辆的临时进口规则
list_license_plate_countries	列出有车牌的国家：国际代码、地区、车牌示例
get_license_plate_country	查询某个国家的车牌格式和所有地区代码
check_license_plate	验证车牌号码并识别其地区代码
get_license_plate_image	标准民用车牌示意图（内嵌 PNG，以及 SVG/PNG 链接）
get_toll_rates	查询某个国家的通行费参考信息：按车辆类别计算的每公里费率、通行贴纸、桥梁和隧道
estimate_route_tolls	将 2–10 个地点名称的路线通行费估算为欧元区间，并标记部分结果
get_holidays	查询未来最多 400 天的公共假日、学校假期（含 ISO 3166-2 地区）和交通高峰日
get_travel_hazards	查询某个国家的 FCDO 旅行建议等级，以及当前 GDACS 灾害和警报等级
get_active_fires	查询过去 48 小时内 NASA FIRMS 卫星在不超过 10°×10° 的边界框中探测到的火灾
get_power_plugs	查询插头类型（IEC A–N）、电压和频率，以及欧洲露营地的接电接口
get_customs_rules	查询驾车入境的海关规定：食品、现金、酒精、烟草、燃油罐，并提供来源引文

所有工具均设置为 readOnlyHint: true 和 openWorldHint: true（它们会调用公开的 openvan.camp API）。默认情况下可安全启用。

---

0.7.0 版本中的重命名： get_vansky_weather → get_country_travel_weather、list_vansky_top → list_best_weather_countries、get_vanbasket → get_country_food_prices、compare_vanbasket → compare_food_prices。托管于 mcp.openvan.camp 的服务仍接受旧名称。

示例提示词

• “使用德国护照规划一趟从慕尼黑到威尼斯的露营车旅行。”
• “这周马拉加的房车天气怎么样？”
• “现在欧洲哪里有最便宜的柴油？”
• “比较德国、法国和西班牙的燃油价格。”
• “这周适合在西班牙露营车野营吗？太阳能发电量怎么样？”
• “查找今年夏天德国即将举办的 vanlife 节。”
• “按今天的汇率将 500 EUR 换算成土耳其里拉。”
• “葡萄牙的食品价格和土耳其相比怎么样？”
• “俄罗斯哪个地区的车牌代码是 199？给我看看带有该代码的车牌。”
• “下周法国有学校假期或交通高峰日吗？”
• “瓦伦西亚附近现在有野火吗？”
• “我可以开车把奶酪和香肠带入挪威吗？”

---

工作原理

该服务是一个基于公开 OpenVan.camp REST API 的轻量 TypeScript 封装：

MCP host ─► @openvancamp/mcp-server ─► https://openvan.camp/api/*

plan_road_trip 通过 POST /api/roadbook/from-places 创建行程手册，等待路线构建完成，并使用行程手册自带的引擎（engine/，由 npm run sync-engine 复制的 openvan.camp 行程手册代码）计算计划，因此答案与行程手册页面一致。

每个出站请求都会自动附加 ?source=mcp-server 以进行来源归因跟踪，并设置描述性 User-Agent（openvan-mcp/<version>）。这有助于我们在公开报告中标注 MCP 集成来源，并对流量进行细分。

配置

环境变量（可选）：

• OPENVAN_API_URL — 覆盖基础 URL（默认值为 https://openvan.camp）
• OPENVAN_SOURCE — 覆盖来源归因标签（默认值为 mcp-server）

速率限制

每个 IP 每分钟 120 个请求。响应中包含 X-RateLimit-Remaining 标头。如果达到限制，请联系 [email protected]，为你的集成申请更高的配额。

---

开发

git clone https://github.com/openvancamp/openvan-camp-public-api.git
cd openvan-camp-public-api/mcp-server
npm install
npm run build
npm start

通过 stdio 进行冒烟测试：

printf '%s\n%s\n%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.0.0"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | node dist/index.js

---

许可证

此服务采用 MIT 许可证。服务返回的数据采用 CC BY 4.0 许可证 — 使用时请注明 OpenVan.camp。

链接

• 网站：https://openvan.camp
• AI Agent 介绍页：https://openvan.camp/ai
• OpenAPI 架构：https://openvan.camp/.well-known/openapi.json
• Claude 连接器：https://claude.ai/directory/connectors/openvan-travel
• ChatGPT 应用：https://chatgpt.com/plugins/plugin_asdk_app_69e458a2ea748191a71a07f7f673234c
• Telegram 机器人：https://t.me/OpenVanCampBot
• 如何连接（供读者参考）：https://openvan.camp/en/assistant
• 联系方式：[email protected]