MCPHub LabRegistrynukeop/nuclear
nukeop

nukeop/nuclear

Built by nukeop 17,096 stars

What is nukeop/nuclear?

Streaming music player that finds free music for you

How to use nukeop/nuclear?

1. Install a compatible MCP client (like Claude Desktop). 2. Open your configuration settings. 3. Add nukeop/nuclear using the following command: npx @modelcontextprotocol/nukeop-nuclear 4. Restart the client and verify the new tools are active.
🛡️ Scoped (Restricted)
npx @modelcontextprotocol/nukeop-nuclear --scope restricted
🔓 Unrestricted Access
npx @modelcontextprotocol/nukeop-nuclear

Key Features

Native MCP Protocol Support
Real-time Tool Activation & Execution
Verified High-performance Implementation
Secure Resource & Context Handling

Optimized Use Cases

Extending AI models with custom local capabilities
Automating system workflows via natural language
Connecting external data sources to LLM context windows

nukeop/nuclear FAQ

Q

Is nukeop/nuclear safe?

Yes, nukeop/nuclear follows the standardized Model Context Protocol security patterns and only executes tools with explicit user-granted permissions.

Q

Is nukeop/nuclear up to date?

nukeop/nuclear is currently active in the registry with 17,096 stars on GitHub, indicating its reliability and community support.

Q

Are there any limits for nukeop/nuclear?

Usage limits depend on the specific implementation of the MCP server and your system resources. Refer to the official documentation below for technical details.

Official Documentation

View on GitHub
<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="packages/ui/src/assets/logo-full-light-outlined.svg"> <source media="(prefers-color-scheme: light)" srcset="packages/ui/src/assets/logo-full-outlined.svg"> <img alt="Nuclear Music Player" src="packages/ui/src/assets/logo-full-outlined.svg" width="400"> </picture> </p> <p align="center"> Nuclear is a free, open-source music player without ads or tracking. Search for any song or artist, build playlists, and start listening.<br> Runs on Windows, macOS, and Linux. </p>

Screenshots

<p align="center"> <img src="packages/docs/.gitbook/assets/dashboard-main.png" alt="Nuclear Music Player - Dashboard" width="100%"> </p>

Nuclear comes with multiple built-in themes:

<p align="center"> <img src="packages/docs/.gitbook/assets/dashboard-green.png" alt="Green theme" width="32%"> <img src="packages/docs/.gitbook/assets/dashboard-aqua.png" alt="Aqua theme" width="32%"> <img src="packages/docs/.gitbook/assets/dashboard-mint.png" alt="Mint theme" width="32%"> </p> <p align="center"> <img src="packages/docs/.gitbook/assets/dashboard-orange.png" alt="Orange theme" width="32%"> <img src="packages/docs/.gitbook/assets/dashboard-red.png" alt="Red theme" width="32%"> <img src="packages/docs/.gitbook/assets/dashboard-violet.png" alt="Violet theme" width="32%"> </p>
Search artistsSearch albums
Artist searchAlbum search
PlaylistsPlugin store
PlaylistsPlugin store
Installed pluginsPreferences
Installed pluginsPreferences
What's newLog viewer
What's newLog viewer

Download

Grab the latest release for your platform from the Releases page.

PlatformFormats
Windows.exe installer, .msi
macOS.dmg (Apple Silicon and Intel)
Linux.AppImage, .deb, .rpm, .flatpak

Features

  • Search for music and stream it from any source
  • Browse artist pages with biographies, discographies, and similar artists
  • Browse album pages with track listings
  • Queue management with shuffle, repeat, and drag-and-drop reordering
  • Favorites (albums, artists, and tracks)
  • Playlists (create, import, export, import from varous services)
  • Powerful plugin system with a built-in plugin store
  • Themes (built-in and custom CSS themes)
  • MCP server lets your AI agent drive the player
  • Auto-updates
  • Keyboard shortcuts
  • Localized in multiple languages

Plugins

Nuclear has a powerful plugin system now! Every functionality has been redesigned to be driven by plugins.

Plugins can provide streaming sources, metadata, playlists, dashboard content, and more. Browse and install plugins from the built-in plugin store, or write your own using the @nuclearplayer/plugin-sdk.

MCP

You can enable the MCP server in Settings → Integrations.

Then to add it to Claude Code:

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

Codex CLI:

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

OpenCode:

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

Claude Desktop / Cursor / Windsurf:

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

The MCP is designed to be discoverable, but there's a skill you can load to get your AI up to speed: Nuclear MCP Skill

Development

Nuclear is a pnpm monorepo managed with Turborepo. The main app is built with Tauri (Rust + React).

Prerequisites

  • Node.js >= 22
  • pnpm >= 9
  • Rust (stable)
  • Platform-specific Tauri dependencies (see Tauri docs)

Getting started

git clone https://github.com/nukeop/nuclear.git
cd nuclear
pnpm install
pnpm dev

Useful commands

pnpm dev            # Run the player in dev mode
pnpm build          # Build all packages
pnpm test           # Run all tests
pnpm lint           # Lint all packages
pnpm type-check     # TypeScript checks
pnpm storybook      # Run Storybook

Community

License

AGPL-3.0. See LICENSE.

Global Ranking

8.5
Trust ScoreMCPHub Index

Based on codebase health & activity.

Manual Config

{ "mcpServers": { "nukeop-nuclear": { "command": "npx", "args": ["nukeop-nuclear"] } } }