radiomcp

Internet radio + AI DJ for Claude and your terminal. ~55,000 stations, 197 countries.

pip install radiomcp && radiomcp

First run auto-registers with Claude Desktop / Claude Code. Restart Claude and you're done.

Powered by Airtune API (55,000+ radio stations worldwide)

Features

• MCP Server — Control radio with natural language through Claude

• TUI Player — Interactive terminal player with search and favorites

• AI DJ Broadcast — 24/7 personalized DJ with voice commentary, news, and music

• Apple Music Integration — Native library playback via persistent ID

• Video Playback — Watch YouTube/live streams in a window on your Mac

• Multi-provider Music — YouTube, Apple Music, Spotify support

Related MCP server: Spotify MCP Server

Quick Start

MCP Server (Claude Integration)

pip install radiomcp && radiomcp

Auto-detected and registered on first run. Or manually add to ~/.claude/settings.json:

{
  "mcpServers": {
    "radio": { "command": "radiomcp" }
  }
}

Then just ask Claude:

"Play some late-night jazz"
"Start a DJ set with K-pop hits"
"Play Bruno Mars from my Apple Music library"
"Show me a live news stream"
"What's playing right now?"

TUI Player

radio

Interactive terminal player. Type to search, numbers to play.

DJ Broadcast System

The killer feature: AI-powered personalized radio broadcast.

Claude: "Start a morning DJ set with upbeat K-pop"

What it does:

• Voice DJ commentary between songs (edge-tts, 10+ languages)

• Live news integration from RSS feeds

• 24-hour scheduling with genre/mood slots

• Cross-instance playback lock — only one plays at a time

• Apple Music native playback — no clicking, uses persistent ID

• YouTube fallback — if track not in library

DJ Tools

Radio Tools

TUI Keyboard Shortcuts

Search

Playback

Favorites

Player Backends

Auto-detected: mpv → vlc → ffplay → browser

brew install mpv      # macOS (recommended)
apt install mpv       # Linux

Environment Variables

License

• Code: MIT — LICENSE

• Station data: ODbL 1.0 — DATA_LICENSE.md

한국어 / Korean

radiomcp — AI DJ 인터넷 라디오

Claude와 터미널을 위한 인터넷 라디오 + AI DJ. 55,000+ 방송국, 197개국.

pip install radiomcp && radiomcp

첫 실행 시 Claude Desktop/Claude Code에 자동 등록됩니다.

주요 기능

• MCP 서버 — Claude에서 자연어로 라디오 제어

• TUI 플레이어 — 터미널에서 검색 + 즐겨찾기

• AI DJ 방송 — 24시간 맞춤형 DJ (음성 코멘트, 뉴스, 음악)

• Apple Music 연동 — 라이브러리에서 바로 재생 (클릭 없이)

• 비디오 재생 — YouTube/라이브 스트림을 창으로 시청

• 멀티 프로바이더 — YouTube, Apple Music, Spotify 지원

사용 예시

Claude에게 말하기:

"재즈 틀어줘"
"심수봉 노래로 DJ 셋 시작해"
"내 애플 뮤직에서 BTS 틀어줘"
"YTN 라이브 뉴스 보여줘"
"지금 뭐 나와?"

DJ 방송 시스템

핵심 기능: AI 기반 맞춤형 라디오 방송

• 음성 DJ 코멘트 — 곡 사이에 AI 목소리 (한국어 포함 10개 언어)

• 실시간 뉴스 — RSS 피드에서 자동 수집

• 24시간 스케줄 — 시간대별 장르/분위기 설정

• 크로스-인스턴스 잠금 — 여러 인스턴스 중 하나만 재생

• Apple Music 네이티브 — persistent ID로 정확한 재생

• YouTube 폴백 — 라이브러리에 없으면 자동 전환

DJ 도구

라디오 도구

설치

pip install radiomcp

# 플레이어 백엔드 (하나만 있으면 됨)
brew install mpv      # macOS 권장

v1.2.7 새 기능

• Apple Music 네이티브 재생 — GUI 클릭 없이 persistent ID로 정확한 재생

• DJ 라이브러리 큐잉 — 재생 전 라이브러리 곡 미리 확인

• 크로스-인스턴스 잠금 — 여러 radiomcp 인스턴스 간 재생 충돌 방지

• 창 비디오 재생 — dj_play_video로 YouTube/라이브 스트림 시청

• dj_health 개선 — Apple Music 재생도 정상 상태로 인식

라이선스

• 코드: MIT

• 방송국 데이터: ODbL 1.0