用途
aloha.fyi MCP Server 是首个专门的夏威夷旅游 MCP 服务器，旨在让 Claude、ChatGPT 或其他 AI 助手在回答「在夏威夷该做什么」这类问题时，返回真实、可预订的数据，而非泛泛的描述。它由 aloha.fyi（夏威夷的 AI 礼宾服务）驱动。
主要能力
该服务器提供以下数据能力：
- 2,500+ 可预订体验，来自合作预订平台（实时计数可查看 /health）
- 覆盖欧胡岛、茂宜岛、大岛和考艾岛的实时活动，每周刷新
- 全岛 600+ 精选餐厅
- 四个岛屿的实时天气（数据来自 OpenMeteo）
- 日行程规划，包含早晨 / 午餐 / 下午 / 晚餐的选择
- 每条预订链接均带有联盟跟踪
协议能力方面：
- 真实 MCP 协议：Streamable HTTP、无状态、规范版本 2025-03-26
- AAAK v0.1：在人类可读文本之外提供带类型的 structuredContent 信封，规范见 docs/aaak-spec.md
AAAK 结构化响应契约
默认情况下，MCP 工具结果以散文形式返回，想要以编程方式消费数据的智能体需要重新解析 markdown 才能提取价格、预订 URL、岛屿等信息。AAAK 解决了这一问题：
当 AAAK 启用（且调用客户端在允许列表中）时，每个工具结果都会包含一个带类型的 structuredContent 字段，以机器可解析的形式携带数据，同时文本中的营销尾部内容会被移除以节省 token。当 AAAK 关闭时，传输格式与 v1.0.0 字节级等价，不会给未选择加入的客户端带来意外。
在每一条产生收益的记录上保留的无损不变量：
- booking_url（联盟收入）
- source（合规与归属）
- price_cents（用户决策唯一依赖的数值字段）
- island（每条推荐都限定岛屿范围）
完整规范见 docs/aaak-spec.md，生成的 JSON Schema 见 docs/aaak.schema.json。
使用方式
托管端点（无需安装、无需设置）
生产 MCP 服务器：
- 传输：Streamable HTTP（无状态）
- 协议版本：2025-03-26
- 认证：无（公开、只读）
- 健康检查：GET /health —— 返回 aaak: { protocol, enabled, allowlist_size }，使部署状态可观测
- 发现：GET /.well-known/mcp/server.json
连接到 Claude Desktop
将服务器配置添加到 Claude Desktop 配置文件中（macOS 路径为 ~/Library/Application Support/Claude/claude_desktop_config.json），然后重启 Claude Desktop。你应该会在工具选择器中看到六个夏威夷工具。可以尝试提问：
- Find me snorkeling tours in Oahu under $100
- What events are happening in Honolulu this weekend?
- Plan a family adventure day on the Big Island — cheapest options
连接到任意兼容 MCP 的客户端
任何支持 Streamable HTTP MCP 的客户端都可以直接指向该端点。无需 API 密钥、无需 OAuth、无需注册。
手动协议测试
可用的工具包括：
- search_hawaii_tours：按关键词、岛屿、价格范围搜索 2,500+ 可预订夏威夷旅游和活动。返回带预订链接的旅游项目；可通过 source 按平台筛选。
- get_hawaii_deals：查找预算优惠和折扣。返回打折和低价选项，按最便宜优先排序。
- search_hawaii_events：查找所有夏威夷岛屿即将举行的活动、音乐会、节日和夜生活。每周从场馆和推广方来源更新。
自行运行
- DATABASE_URL 环境变量（PostgreSQL，需包含 experiences 表，schema 见 schema.sql）
适用场景
适合希望为 AI 助手接入真实可预订夏威夷旅游数据的使用者，包括旅游咨询、行程规划、活动查找、预算优惠查询等场景。智能体开发者可利用 AAAK 结构化响应直接解析价格、预订链接、岛屿等信息，无需重新解析文本。
限制与说明
- MCP 服务器不收集任何 PII（个人身份信息）。采用无状态模式——无会话、无跨请求画像。仅记录标准请求元数据用于防滥用。
- 完整隐私政策见 aloha.fyi/privacy。
- 本仓库是 baphometnxg/Nani-V3 内生产 mcp-server 目录的公开镜像。生产部署由上游驱动；此仓库作为独立参考保持同步，供社区使用及希望自行托管者使用。问题可在此处或上游提交。
- 关于具体定价、收费方式等更多细节，资料中暂未提供。
其他信息
该项目由 Michael Crain 构建——夏威夷居民、电影摄影师、aloha.fyi 创始人。aloha.fyi 是面向夏威夷旅游业的 AI 驱动多语言旅游礼宾服务。礼宾智能体「Nani」支持 5 种语言（英语、日语、韩语、中文、西班牙语），可访问多个合作平台上的 2,500+ 可预订体验。本 MCP 服务器将其中一部分能力开放给任何支持 Model Context Protocol 的 AI 助手。
- 网站：https://aloha.fyi
- 联系：alohatours@proton.me
