
Nuclear MCP
Nuclear MCP is the built-in Model Context Protocol server for Nuclear, a popular free open-source music player. It enables AI coding agents and assistants (Claude, Cursor, etc.) to control music playback, search songs/artists, manage playlists, and interact with the player hands-free.
Overview
Nuclear MCP is the integrated Model Context Protocol (MCP) server built into Nuclear, a popular free and open-source desktop music player. Nuclear lets users search and stream music from various online sources without ads or tracking, and the MCP server extends this by allowing AI agents to directly control the player.
With 17k+ GitHub stars, Nuclear combines a modern Tauri-based desktop app (TypeScript + Rust) with powerful features like playlist management, favorites, themes, and plugins. The MCP integration makes it one of the most practical "fun" MCP servers, turning your AI coding assistant into a hands-free music companion.
Key Features
- Music Control Tools: Play, pause, skip tracks, adjust volume, shuffle, and repeat via AI commands.
- Search & Discovery: Search for songs, artists, or albums and stream results directly.
- Playlist Management: Create, edit, import, export, and manage playlists programmatically.
- Queue & Favorites: Add tracks to queue, manage favorites, and browse artist/album details.
- Plugin & Theme Support: AI can potentially interact with the extensible plugin system.
- Local HTTP Endpoint: Runs on
http://127.0.0.1:8800/mcpwhen enabled. - Cross-Platform: Works on Windows, macOS, and Linux.
How It Works
- Launch Nuclear and enable the MCP server in Settings → Integrations.
- Add the server to your MCP client (Claude Desktop, Cursor, Windsurf, etc.) using the provided URL.
- Your AI agent discovers Nuclear's tools and can issue natural language commands like "play lo-fi beats", "add this song to my focus playlist", or "search for new albums by artist X".
The MCP server translates agent requests into actions within the running Nuclear application.
Use Cases
- Hands-Free Coding Sessions: Ask your AI to play focus music, change tracks, or build study playlists while you code.
- Productivity Workflows: Integrate background music control into multi-agent setups or daily routines.
- Creative Assistance: Have AI curate playlists based on mood, task, or genre during brainstorming.
- Demo & Fun Integrations: Showcase MCP capabilities with a relatable desktop app.
- Custom Automation: Combine with other MCP servers (e.g., timers, notifications) for smart workspace orchestration.
Getting Started
- Download and install Nuclear from the official GitHub releases or Flathub.
- Open Nuclear → go to Settings → Integrations and enable the MCP server.
- Add it to your AI client. Examples:
- Claude Desktop / Cursor:
{ "mcpServers": { "nuclear": { "url": "http://127.0.0.1:8800/mcp" } } }
- Claude Desktop / Cursor:
Full setup details are in the Nuclear documentation under Integrations → MCP Server.
Benefits
Nuclear MCP brings a delightful, practical use case to the MCP ecosystem. Instead of only serious developer tools, it shows how MCP can control everyday desktop applications. The player itself is privacy-focused, feature-rich, and actively maintained, making the MCP integration a seamless addition for users who want AI-powered music control.
Main Repository: https://github.com/nukeop/nuclear
Nuclear demonstrates the versatility of MCP beyond coding and data tools — extending AI agency into entertainment and productivity apps.
Tags
Related Entries
Keep exploring similar tools and resources in this category.
Related Reads
Background, tutorials, and protocol context connected to this entry.







