Thailand Fun Experiences

泰国趣味体验 — MCP 服务

面向 Agent 的普吉岛体验服务层，让 AI 助手（ChatGPT、Claude 等）通过一次工具调用，就能回答“今天我们这群人适合在这里做什么？”——提供经过安全筛选的属性、实时天气和海况信息，以及联盟预订链接。

在线体验： thailandfunexperiences.com · MCP 端点：https://thailandfunexperiences.com/mcp

功能

• 1,891 项真实 Viator 体验已同步，其中 352 项补充了 24 项安全性／适宜性属性
• 组合排序——返回 4 个多样化候选项（而非前 k 项），并进行场所去重、活动类型多样化和类别分布
• 实时背景信息——天气预报（根据时段划分降雨等级）、海况（涌浪方向 × 区域暴露程度）、交通矩阵（通过 ORS 路由，覆盖 13 个区域）、季节
• 安全筛选——年龄门槛、行动能力（以能否享受核心体验为判断依据）、怀孕、不会游泳、对晕动的耐受度；均采用多来源证据层级
• 联盟预订——每条结果都包含带追踪功能的预订链接（book_now_url），并提供实时可订情况

架构

完整规范请参阅 ARCHITECTURE.md。

Agents (ChatGPT / Claude / REST)
        │
        ▼
  M6 MCP Server (Fastify + streamable HTTP)
        │
  M5 Ranker (pure function, no DB/API calls)
   ├── M1 Experience Graph (Postgres + PostGIS)
   ├── M4 Context (Open-Meteo weather/marine, ORS matrix)
   └── M3 Enrichment (Claude Sonnet, Batch API)
        │
  M8 Router → Viator affiliate links
  M10 Telemetry → session/click/booking events

工具

search_experiences

搜索适合同行游客的普吉岛活动。返回约 4 条多样化推荐。

{
  "date": "2026-09-10",
  "staying": "kata",
  "party": [{"role": "adult", "age": 38}, {"role": "child", "age": 9}],
  "constraints": {"motion_comfort": "low"},
  "energy": "high",
  "time_slot": "morning",
  "max_results": 4
}

响应包含：候选项及其属性、预订链接、原因代码、天气背景信息、海况、目录广度统计数据，以及细化提示。

get_experience

根据 ID 获取特定体验的完整详情。

{"experience_id": "exp_27613P9"}

技术栈

• 运行时： Node 22、TypeScript（严格模式）、ESM
• 单体仓库： pnpm workspaces
• 数据库： Postgres 16 + PostGIS、Drizzle ORM
• MCP： @modelcontextprotocol/sdk 流式 HTTP 传输，运行于 Fastify 之后
• 信息补充： Anthropic Batch API（Claude Sonnet 4），通过证据验证进行结构化提取
• 天气／海洋： Open-Meteo（无需密钥）
• 交通矩阵： OpenRouteService（一次批量矩阵调用，覆盖全部 13 个区域）
• 部署： VPS 上的 systemd + Caddy 反向代理

证据层级

1. human_correction    — Dan's per-attribute overrides
2. operator_terms      — verified T&C from specific operators
3. viator_structured   — supplier-declared flags (stored verbatim)
4. dan-rules           — category/venue-level local knowledge (8 rule groups)
5. derived             — formula-computed (seasickness = vessel × water_exposure)
6. extraction          — LLM structural/textual inference (base)

关键设计决策

• 组合，而非前 k 项——从不同场所／活动类型中挑选 4 个多样化候选项
• 结构化约束，而非自由文本——任何字段都不包含健康相关表述（隐私保护设计）
• 始终启用交通惩罚——交通时间／体验时长比 ≥1 时施加强惩罚
• 对不支持的目的地平稳降级——绝不抛出错误，并记录需求
• 指令 9（Viator 明日测试）——每项提供的功能都必须带来转化、佐证、组合或背景信息，且这些内容不能由单一服务商复制

构建方式

使用 Claude Code（Claude Opus）独立开发，耗时约 1 周。构建复盘请参阅 meta/POSTMORTEM.md。

许可证

MIT