opplevagent-mcp

opplevagent-mcp

适用于 opplevagent.no 的 MCP 服务——通过 Claude Desktop、ChatGPT、Cursor 和其他 AI 助手查找挪威的体验和活动。

精选且经 Brreg 验证的体验，可按郡、类别、天气、季节、团体人数、价格和时长搜索。

安装

npx opplevagent-mcp

或者添加到 Claude Desktop 配置文件（~/.claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "opplevagent": {
      "command": "npx",
      "args": ["opplevagent-mcp"]
    }
  }
}

工作原理

从 0.4.0 起，该软件包是连接实时远程服务（ https://opplevagent.no/mcp）的轻量级 stdio 桥接程序。工具、描述、说明和界面资源始终 与远程服务保持一致，因此 npm 软件包和远程服务不会出现偏差，且自由文本 query 会原样传递给 discover_experiences。远程服务的速率限制同样适用。

远程服务（Streamable HTTP）

对于 ChatGPT 和其他远程 MCP 客户端，直接粘贴此 URL：

https://opplevagent.no/mcp

工具

工具	描述
discover_experiences	按郡（fylke）、类别、天气、季节、室内／室外、团体人数、年龄、价格和时长搜索体验
list_experience_categories	列出所有类别及体验数量
get_experience	通过 UUID 获取某项体验的完整详情
discover_gardssalg	按郡、市镇、生产者类型、附近距离、预订状态搜索 gårdssalg（农场直售）饮品生产者——也可通过 query 按名称查找。每行包含 id（用于预订的 provider_id）
book_gardssalg	向 gårdssalg 生产者提交待处理的预订请求（不会确认预订——由生产者回复）。接受 provider_query（生产者名称）而非 provider_id，并支持 requested_weekday 以防选错日期，因此一句话（«预订 10 月 20 日星期五 10 点在 X 处见面»）即可完成一次调用

示例

hva kan vi finne på i Troms om vinteren?
utendørsaktiviteter i Oslo for 4 personer
opplevelser som passer i regnvær i Bergen
hvalsafari Tromsø
familievennlige aktiviteter under 500 kr
hvilke typer opplevelser finnes i Norge?
book et besøk hos Fjordgard Bryggeri fredag 23. oktober kl. 10 for 4 personer

一句话预订（gårdssalg）

«预订 10 月 20 日星期五 10 点在 X 处见面»只需调用一次 book_gardssalg：

字段	值
provider_query	"X"——客人提到的生产者名称（或使用 discover_gardssalg 获取的 provider_id）
slot_at	"2026-10-20T10:00"（Europe/Oslo）
requested_weekday	"fredag"——如果 20 日不是星期五，工具会返回 weekday_mismatch:true 并提供最近的几个星期五，而不是预订错误日期
party_size、guest_name、guest_email	人类客人本人的信息——请向他们询问，切勿自行编造

结果始终如实且明确：provider_not_found、provider_ambiguous（附上可提供给客人选择的候选项）、weekday_mismatch（附上建议）、paused（生产者尚未启用预订——包含个人资料链接）、outside_hours（使用 confirm_outside_hours:true 重试），或返回包含 booking_ref、解析后的 provider.navn 和 slot_at_local 的待处理请求。生产者会收到电子邮件通知，并确认、提议其他时间或拒绝——工具本身绝不会确认预订。

桥接程序会发送什么

除了每次调用的工具参数外，桥接程序还会通过两种方式向远程服务标识自身：MCP clientInfo（AI 客户端的名称和版本，格式为 " via opplevagent-mcp"）以及格式为 opplevagent-mcp/<version> 的 User-Agent 标头。这些是 客户端统计信息，并非用于识别你的信息：不会发送账号、凭据或设备标识符。服务器会保留常规的 Web 请求日志（IP 地址和请求元数据），用于运维和防止滥用。

预订（gårdssalg）

book_gardssalg 无需登录，且受服务器速率限制。调用会将 客人的姓名和电子邮件地址发送到 opplevagent.no。请求会保持待处理状态，直到 生产者回复；工具不会确认预订。AI 客户端应在调用工具前获得客人的明确同意。

信任边界

每次桥接程序启动时，都会通过 HTTPS 从远程服务（https://opplevagent.no/mcp）获取工具列表、工具描述和服务指令。此软件包不会对这些内容进行固定或冻结，因此 AI 客户端看到的内容取决于远程服务当前提供的内容。 OPPLEVAGENT_URL 可覆盖远程 URL，而你或 AI 客户端提供的每个工具参数都会发送到该主机。请仅通过你信任的配置设置此变量。

环境变量

变量	默认值	描述
OPPLEVAGENT_URL	https://opplevagent.no	覆盖远程基础 URL（或完整的 /mcp URL）

许可证

MIT