radio-browser-mcp ♫

MCP server for Radio-Browser internet radio + Claude Code status line with audio spectrum.

♫ BBC Radio 1 ▂▄▆█▇▅▃▂▃▅▇█

Features

• MCP Server — control internet radio from Claude Code via natural language

• Radio-Browser — browse 30,000+ global stations by popularity, genre, country

• Auto-start mpv — no manual mpv --input-ipc-server needed

• Status Line — real-time now-playing + spectrum visualization

• Cross-platform — macOS / Linux / Windows

Quick Start

# Install
cd radio-browser-mcp
./install.sh          # macOS / Linux
# .\install.ps1       # Windows PowerShell

# Restart Claude Code, then use:
# "Play some jazz" → Claude calls browse_radio(tag="jazz")
# "下一首" → Claude calls next_station()

MCP Tools

CLI Usage

# Run MCP server (default, used by Claude Code)
radio-browser-mcp

# Browse popular radio stations
radio-browser-mcp --browse
radio-browser-mcp --browse --tag jazz --limit 5

# Status line output (used by statusLine config)
radio-browser-mcp --status

# Stop
radio-browser-mcp --stop

# Check setup
radio-browser-mcp --check

# Test spectrum visualization
radio-browser-mcp --spectrum

Requirements

• Python 3.10+

• mcp package (auto-installed)

• httpx package (auto-installed)

• mpv (for playback)

• ffmpeg (for spectrum capture, optional - animated fallback without it)

• pywin32 (Windows only, for named pipe support)

License

MIT