RoamDial — World Radio Map

RoamDial MCP サーバー — 3D 地球儀で楽しむ世界のライブラジオ

RoamDial は、215 の国と地域にわたる35,000 以上の検証済みライブラジオストリームを楽しめる、無料で広告のないインタラクティブな 3D 世界ラジオマップです。

このリポジトリでは、RoamDial の公式 Model Context Protocol（MCP） 統合を提供します。

1. 直接接続するリモートの Streamable HTTP サーバー（https://roamdial.com/mcp） — インストール不要、API キーや認証も不要です。
2. 軽量なローカル stdio ブリッジ（npx -y github:ddter/roamdial-mcp） — ローカル専用の MCP クライアント向けの、依存関係ゼロの Node.js ラッパーです。

---

クイックスタート

オプション 1：リモート Streamable HTTP（推奨 — インストール不要）

Streamable HTTP（2025-06-18 ／ 2025-03-26 ／ 2026-07-28）に対応する任意の MCP クライアントから、次の URL に直接接続します。

https://roamdial.com/mcp

Claude Code

claude mcp add --transport http roamdial https://roamdial.com/mcp

Cursor ／ VS Code ／ Windsurf（mcp.json）

{
  "mcpServers": {
    "roamdial": {
      "url": "https://roamdial.com/mcp"
    }
  }
}

OpenAI Codex（~/.codex/config.toml）

[mcp_servers.roamdial]
url = "https://roamdial.com/mcp"

ChatGPT ／ Claude.ai Web コネクター

Settings → Connectors で https://roamdial.com/mcp を追加します（認証は不要です）。

---

オプション 2：ローカル stdio ブリッジ（claude_desktop_config.json）

ローカルの stdio プロセスのみをサポートする MCP クライアント向けです（Node.js >= 18 が必要です）。

{
  "mcpServers": {
    "roamdial": {
      "command": "npx",
      "args": ["-y", "github:ddter/roamdial-mcp"]
    }
  }
}

---

利用可能な MCP ツール（4 件）

すべてのツールは読み取り専用で、認証は不要です。人が読みやすい Markdown（content）と、機械処理向けの型付き JSON（structuredContent + outputSchema）の両方を返します。また、ワンクリックで直接再生できる URL（listenUrl および 3D 地球儀の mapUrl）も含まれます。

1. search_stations

キーワード、国、都市、ジャンル、言語を指定して、35,000 以上の検証済みライブストリームからラジオ局を検索します。

• パラメーター：
  • query (文字列、任意)：ラジオ局名、コールサイン、周波数、都市、またはキーワード（例："BBC"、"Jazz"、"Tokyo"、"KEXP"）。
  • country (文字列、任意)：ISO-2 国コード、国のスラッグ、または国名（例："JP"、"united-kingdom"、"Brazil"）。
  • city (文字列、任意)：都市名のフィルター（例："Paris"、"New York"、"Seoul"）。
  • genre (文字列、任意)：ジャンルのスラッグまたはキーワード（例："jazz"、"classical"、"news"、"electronic"、"rock"、"ambient"）。
  • language (文字列、任意)：放送言語のフィルター（例："English"、"Japanese"、"French"）。
  • limit (整数、任意、1～20、デフォルト 10)：返すラジオ局の最大数。

2. spin_globe

3D 地球儀を回して、ランダムなライブラジオ局に止めます。国、ジャンル、または気分／時間帯で絞り込み、ライブの ICY 楽曲タイトルを確認することもできます。

• パラメーター：
  • country (文字列、任意)：ISO-2 コード、スラッグ、または国名。
  • genre (文字列、任意)：ジャンルのスラッグまたはキーワード。
  • mood (列挙型、任意)：
    • "late_night" — 放送都市の現地時刻が現在 22:00～04:00 のラジオ局
    • "morning" — 放送都市の現地時刻が現在 06:00～10:00 のラジオ局
    • "focus" — インストゥルメンタル／アンビエント／クラシック／ジャズ／ローファイのラジオ局
    • "upbeat" — ポップ／ロック／ダンス／エレクトロニック／ラテン／ヒップホップのラジオ局
    • "relax" — チル／イージーリスニング／アンビエント／アコースティック／スムーズジャズのラジオ局

3. get_station

12 桁の 16 進数 ID または slug-id を使って、放送地域、現地時刻、ストリームのコーデックとビットレート、Wikipedia の概要、RoamDial のリスナー統計、ライブの ICY トラックメタデータ、類似する放送局など、放送局の全プロフィールを取得します。

• パラメーター：
  • stationId (string, required)：12 文字の 16 進数 ID（例："961bf53d0601"）または放送局のスラッグ（"bbc-radio-3-961bf53d0601"）。

4. get_now_playing

放送局で現在配信中のライブ ICY StreamTitle メタデータを照会します（observedAt のタイムスタンプと、利用できない理由も明示します）。

• パラメーター：
  • stationId (string, required)：12 文字の 16 進数 ID または slug-id。

---

試してみるプロンプト

• 「今まさにライブ放送中で、現地時刻が深夜0時を過ぎている深夜のジャズ放送局を探して、何の曲が流れているか教えてください。」
• 「東京または京都のライブラジオ局を検索して、聴取用の直接リンクを教えてください。」
• 「地球儀を回して、世界のどこかの朝のラジオ番組をランダムに選んでください。」
• 「KEXP または BBC Radio 3 では、今何が流れていますか？」

---

AI と探索のための追加エンドポイント

• 3D ワールドラジオマップ：https://roamdial.com
• RFC 9727 API カタログ：https://roamdial.com/.well-known/api-catalog
• OpenAPI 3.1 仕様（Custom GPT Actions 向け）：https://roamdial.com/openapi.json
• LLM 向けサマリー（llms.txt）：https://roamdial.com/llms.txt
• LLM 向け完全キュレーションカタログ（llms-full.txt）：https://roamdial.com/llms-full.txt

---

ライセンス

MIT © RoamDial