# 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.

Canonical URL: https://a2a-mcp.org/entry/nuclear-mcp

Language: en

Category: MCP Servers

Updated: 2026-04-11

## Overview

**Nuclear MCP** is the integrated **Model Context Protocol (MCP) server** built into [Nuclear](https://github.com/nukeop/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/mcp` when enabled.
- **Cross-Platform**: Works on Windows, macOS, and Linux.

## How It Works

1. Launch Nuclear and enable the MCP server in **Settings → Integrations**.
2. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf, etc.) using the provided URL.
3. 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

1. Download and install Nuclear from the [official GitHub releases](https://github.com/nukeop/nuclear/releases) or Flathub.
2. Open Nuclear → go to **Settings → Integrations** and enable the MCP server.
3. Add it to your AI client. Examples:
   - **Claude Desktop / Cursor**:
     ```json
     {
       "mcpServers": {
         "nuclear": {
           "url": "http://127.0.0.1:8800/mcp"
         }
       }
     }
     ```

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](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

- mcp
- music-player
- ai-agent
- desktop-app
- tauri
- streaming
- playlist
- typescript
- rust

## Sources

- [Project website](https://github.com/nukeop/nuclear)