Aloha Fyi Hawaii

aloha.fyi MCP サーバー 🌺

ハワイ観光に特化した初の MCP サーバーです。 AI アシスタント向けに、ハワイのツアー、イベント、お得な情報を提供します。さらに AAAK の構造化レスポンスに対応し、コンシューマーエージェントが文章を再解析せずに結果を解析できるようになりました。

Claude、ChatGPT、その他の AI に「ハワイで何をすればいい？」と尋ねると、この MCP サーバーが実際に予約可能なデータを返します。

• 予約可能な体験が2,500件以上。提携予約プラットフォームから取得（最新の件数は /health を参照）
• オアフ島、マウイ島、ハワイ島、カウアイ島のライブイベント。毎週更新
• 島々の厳選レストランが600軒以上
• 4島すべてのリアルタイム天気（OpenMeteo）
• 朝食／昼食／午後／夕食の候補を含む1日のプラン
• すべての予約リンクでアフィリエイトを追跡
• 正式な MCP プロトコル — Streamable HTTP、ステートレス、仕様バージョン 2025-03-26
• AAAK v0.1 — 人間が読めるテキストとともに、型付きの structuredContent エンベロープを返します。docs/aaak-spec.md を参照してください。

aloha.fyi が提供 — ハワイの AI コンシェルジュです。

正規のソースについて。 このリポジトリは、baphometnxg/Nani-V3 内の本番用 mcp-server ディレクトリを公開向けにミラーしたものです。本番環境へのデプロイはそちらから行われます。このリポジトリは、コミュニティでの利用やセルフホストを希望する方のためのスタンドアロンのリファレンスとして、同期を保っています。こちら、または上流リポジトリのどちらに課題を報告してもかまいません。

---

ホスト型エンドポイント

本番 MCP サーバー（インストールや設定は不要）：

https://mcp.aloha.fyi/mcp

• トランスポート：Streamable HTTP（ステートレス）
• プロトコルバージョン：2025-03-26
• 認証：なし（公開、読み取り専用）
• ヘルスチェック：GET /health — aaak: { protocol, enabled, allowlist_size } を返すため、デプロイ状態を確認できます
• ディスカバリー：GET /.well-known/mcp/server.json

---

AAAK — 構造化レスポンス契約

デフォルトでは、MCP ツールの結果は文章のまとまりとして返されます。プログラムでデータを利用するエージェントは、価格や予約 URL、島などを取り出すために Markdown を再解析する必要があります。AAAK はこの問題を解決します。

AAAK が有効で、呼び出し元のクライアントが許可リストに登録されている場合、すべてのツール結果に、機械解析可能な形式でデータを格納した型付きの structuredContent フィールドが含まれます。また、トークンを節約するため、マーケティング用の末尾文は text から削除されます。AAAK が無効の場合、ワイヤ形式は v1.0.0 とバイト単位で同等です。オプトインしていないクライアントに予期しない変更はありません。

損失のない不変条件 — 収益に関わるすべての行で保持されます：

• booking_url（アフィリエイト収益）
• source（コンプライアンスとアトリビューション）
• price_cents（ユーザーの意思決定に影響する唯一の数値フィールド）
• island（すべてのおすすめは島ごとに分類されます）

例（search_hawaii_tours）：

{
  "ok": true,
  "kind": "result",
  "tool": "search_hawaii_tours",
  "protocol": "aaak/0.1",
  "query": { "query": "snorkeling", "island": "oahu", "limit": 1 },
  "results": [
    {
      "title": "Hanauma Bay Snorkel",
      "source": "viator",
      "island": "oahu",
      "area": "east_oahu",
      "category": "tour",
      "price_cents": 8900,
      "rating": 4.7,
      "review_count": 2341,
      "description": "Guided snorkeling at Oahu's most famous reef...",
      "booking_url": "https://aloha.fyi/r/aB3kT9pQz1",
      "is_deal": false
    }
  ],
  "meta": { "count": 1, "cached": false, "source_diversity": 1 }
}

完全な仕様： docs/aaak-spec.md。生成された JSON Schema： docs/aaak.schema.json。

検証スクリプト（セルフホストする方やコントリビューター向け）：

npm run aaak:test    # 12 hand-written conformance fixtures
npm run aaak:smoke   # 9 adapter-output validations
npm run aaak:gate    # ~70 env-gate / trailer / allowlist invariants
npm run aaak:verify -- --expect=aaak --ua=claude-code/1.0   # live probe

---

Claude Desktop に接続する

Claude Desktop の設定ファイル（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "aloha-fyi-hawaii": {
      "url": "https://mcp.aloha.fyi/mcp"
    }
  }
}

Claude Desktop を再起動します。ツールピッカーにハワイ関連の6つのツールが表示されます。次のように試してください。

オアフ島で100ドル以下のシュノーケリングツアーを探してください

今週末、ホノルルではどんなイベントが開催されますか？

ハワイ島で家族向けのアドベンチャーを1日楽しむプランを立ててください。最も安い選択肢をお願いします。

---

MCP 互換クライアントに接続する

Streamable HTTP MCP に対応したクライアントなら、どれでも次のエンドポイントに直接接続できます。

https://mcp.aloha.fyi/mcp

API キーも OAuth も登録も不要です。

プロトコルを手動でテストする

curl -X POST https://mcp.aloha.fyi/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

---

ツール

search_hawaii_tours

キーワード、島、価格帯で、予約可能なハワイのツアーやアクティビティを2,500件以上検索します。予約リンク付きのツアーを返します。source でプラットフォームを絞り込めます。

Param	Type	Description
query	string (required)	例：「シュノーケリング」、「ヘリコプターツアー」、「ファミリー・ルアウ」
island	oahu | maui | big_island | kauai | any	デフォルトは any です
max_price_dollars	number	1人あたりの上限価格（米ドル）
source	viator | gyg | klook | groupon | any	予約プラットフォームで絞り込みます
limit	number	結果数（最大20件、デフォルトは5件）

get_hawaii_deals

お手頃なプランや割引を探します。割引価格や低価格の選択肢を、安い順に返します。

Param	Type	Description
activity	string (required)	例：「シュノーケリング」、「ヘリコプター」、「ルアウ」
max_price_dollars	number	デフォルトは100です
limit	number	結果数（最大20件、デフォルトは5件）

search_hawaii_events

ハワイ諸島全域の今後のイベント、コンサート、フェスティバル、ナイトライフを検索します。会場やプロモーターの情報源から毎週更新されます。

Param	Type	Description
query	string	例：「ライブミュージック」、「ルアウ」、「コンサート」
island	oahu | maui | big_island | kauai | any	デフォルトは any です
days_ahead	number	何日先まで検索するか（デフォルトは7日）

---

自分で実行する

git clone https://github.com/baphometnxg/aloha-fyi-mcp.git
cd aloha-fyi-mcp
npm install
npx tsc
DATABASE_URL="postgresql://..." PORT=9624 node dist/http.js

必要なもの：

• Node.js 20+
• DATABASE_URL 環境変数（experiences テーブルを含むPostgreSQL — スキーマは schema.sql にあります）

---

プライバシー

MCP サーバーは個人を特定できる情報（PII）を収集しません。ステートレスモードのため、セッションやリクエストをまたいだプロファイルはありません。不正利用の防止のみを目的として、標準的なリクエストメタデータを記録します。

プライバシーポリシー全文：aloha.fyi/privacy

---

概要

Michael Crain によって開発されました。ハワイ在住の撮影監督で、aloha.fyi の創設者です。

aloha.fyi は、ハワイの観光業界向けのAI搭載多言語ツーリズムコンシェルジュです。コンシェルジュエージェント「Nani」は5言語（英語、日本語、韓国語、中国語、スペイン語）に対応し、複数のパートナープラットフォームにわたる予約可能な体験を2,500件以上利用できます。

このMCP サーバーは、Model Context Protocol に対応するあらゆるAI アシスタントに、その機能の一部を提供します。

• ウェブサイト：https://aloha.fyi
• 連絡先：[email protected]
• ライセンス：MIT

---

アロハとともに開発。AIを活用し、ハワイの文化に根ざしています。 🌺