nuclear: Driving Free Music Streaming with MCP

nuclear is a TypeScript-based streaming music player designed to find and play free music from various sources. Beyond its core function as a feature-rich player, nuclear stands out as an MCP Client, enabling AI agents to programmatically control music playback and interact with its capabilities. With over 18,500 GitHub stars, it offers a robust platform for integrating music streaming into AI-driven workflows.

Activating the MCP Server

To integrate nuclear with your AI agent, you first need to enable its built-in MCP server. This is done directly within the application's settings. Navigate to Settings → Integrations to activate the server. Once enabled, nuclear exposes an MCP endpoint, typically at http://127.0.0.1:8800/mcp, which your AI client can connect to.

Wiring nuclear into Your AI Environment

Connecting nuclear to various AI development environments is straightforward, leveraging its exposed MCP endpoint. Here are the specific configurations for popular platforms:

Claude Code

For developers using Claude Code, add nuclear as an MCP client with the following command:

claude mcp add nuclear --transport http http://127.0.0.1:8800/mcp

Codex CLI

If you're working with the Codex CLI, the command to add nuclear is similar:

codex mcp add nuclear --url http://127.0.0.1:8800/mcp

OpenCode

For OpenCode users, nuclear can be configured in your mcp settings block:

{
  "mcp": {
    "nuclear": {
      "type": "remote",
      "url": "http://127.0.0.1:8800/mcp"
    }
  }
}

Claude Desktop / Cursor / Windsurf

To integrate nuclear into Claude Desktop, Cursor, or Windsurf, modify your mcpServers configuration:

{
  "mcpServers": {
    "nuclear": {
      "url": "http://127.0.0.1:8800/mcp"
    }
  }

Enhancing AI Agent Capabilities with nuclear

Once connected, nuclear's MCP integration allows AI agents to leverage its extensive feature set. This includes searching for music, streaming tracks, browsing artist and album pages, managing playback queues (shuffle, repeat, reordering), and interacting with favorites and playlists.

To help your AI agent understand nuclear's specific capabilities, a dedicated MCP skill can be loaded. This skill, available as nuclear-mcp.zip, helps the AI agent get "up to speed" on how to interact with the player effectively.

Core Player Features

Beyond its MCP integration, nuclear offers a comprehensive set of features for music enthusiasts:

Music Discovery & Streaming: Search for and stream music from various sources.
Artist & Album Browsing: Explore artist biographies, discographies, and similar artists, as well as album track listings.
Queue Management: Full control over playback queues, including shuffle, repeat, and drag-and-drop reordering.
Personalization: Manage favorites (albums, artists, tracks) and create, import, or export playlists, including imports from other services.
Extensibility: A plugin system with a built-in store, alongside support for custom CSS themes.
Usability: Auto-updates, keyboard shortcuts, and localization in multiple languages.

By exposing these features via MCP, nuclear transforms into a powerful component for AI agents, enabling them to curate and control music experiences programmatically.

nuclear: Free Music Streaming MCP Client for AI Agents