RoamDial — World Radio Map

RoamDial MCP 服务 — 3D 地球仪上的全球实时广播

RoamDial 是免费的、无广告的交互式 3D 世界广播地图，提供 覆盖 215 个国家和地区的 35,000 多个经过验证的实时广播流。

此仓库提供 RoamDial 官方的 Model Context Protocol (MCP) 集成：

1. 直接远程 Streamable HTTP 服务（https://roamdial.com/mcp） — 无需安装，也无需 API 密钥或身份验证。
2. 轻量级本地 stdio 桥接程序（npx -y github:ddter/roamdial-mcp） — 零依赖的 Node.js 封装程序，供仅支持本地的 MCP 客户端使用。

---

快速开始

选项 1：远程 Streamable HTTP（推荐 — 无需安装）

将任何支持 Streamable HTTP（2025-06-18 / 2025-03-26 / 2026-07-28）的 MCP 客户端直接指向：

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 网页连接器

在 设置 → 连接器 下添加 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），其中包含可直接一键收听的网址（listenUrl 和 3D 地球仪 mapUrl）。

1. search_stations

按关键词、国家、城市、流派或语言搜索 35,000 多个经过验证的实时广播流中的电台。

• 参数：
  • query (string，可选)：电台名称、呼号、频率、城市或关键词（例如 "BBC"、"Jazz"、"Tokyo"、"KEXP"）。
  • country (string，可选)：ISO-2 国家代码、国家 slug 或国家名称（例如 "JP"、"united-kingdom"、"Brazil"）。
  • city (string，可选)：城市名称筛选条件（例如 "Paris"、"New York"、"Seoul"）。
  • genre (string，可选)：流派 slug 或关键词（例如 "jazz"、"classical"、"news"、"electronic"、"rock"、"ambient"）。
  • language (string，可选)：广播语言筛选条件（例如 "English"、"Japanese"、"French"）。
  • limit (integer，可选，1–20，默认值为 10)：最多返回的电台数量。

2. spin_globe

旋转 3D 地球仪并随机停在一个实时广播电台上；还可按国家、流派或情绪／时段筛选，并探测其实时 ICY 曲目标题。

• 参数：
  • country (string，可选)：ISO-2 代码、slug 或国家名称。
  • genre (string，可选)：流派 slug 或关键词。
  • mood (enum，可选)：
    • "late_night" — 广播城市当地时间当前处于 22:00–04:00 的电台
    • "morning" — 广播城市当地时间当前处于 06:00–10:00 的电台
    • "focus" — 器乐／氛围／古典／爵士／lo-fi 电台
    • "upbeat" — 流行／摇滚／舞曲／电子／拉丁／嘻哈电台
    • "relax" — 轻松／轻音乐／氛围／原声／柔和爵士电台

3. get_station

通过站点的 12 位十六进制 ID 或 slug-id 获取完整资料，包括广播位置、当地时间、流媒体编解码器/比特率、Wikipedia 背景介绍、RoamDial 听众统计数据、实时 ICY 曲目元数据和类似站点。

• 参数：
  • stationId (string, required)：12 位十六进制 ID（例如 "961bf53d0601"）或站点 slug（"bbc-radio-3-961bf53d0601"）。

4. get_now_playing

查询站点当前正在广播的实时 ICY StreamTitle 元数据（包含明确的 observedAt 时间戳和可用性原因）。

• 参数：
  • stationId (string, required)：12 位十六进制 ID 或 slug-id。

---

可试用的示例提示词

• “帮我找一个现在正在直播的深夜爵士电台，且当地时间已过午夜，并告诉我正在播放什么歌曲。”
• “搜索东京或京都的直播电台，并提供可直接收听的链接。”
• “随机选一个世界某地的早间广播节目。”
• “KEXP 或 BBC Radio 3 现在正在播放什么？”

---

其他 AI 与发现端点

• 3D 世界广播地图：https://roamdial.com
• RFC 9727 API 目录：https://roamdial.com/.well-known/api-catalog
• OpenAPI 3.1 规范（用于自定义 GPT 操作）：https://roamdial.com/openapi.json
• LLMs 摘要（llms.txt）：https://roamdial.com/llms.txt
• LLMs 完整精选目录（llms-full.txt）：https://roamdial.com/llms-full.txt

---

许可证

MIT © RoamDial