Nuclear
BLOCKgrade D · trust 69/100Streaming music player that finds free music for you
agentaidesktop applinuxmacmcpmcp servermusicOverview
From the repository's own README, as read at the audited commit.
<p align="center"> <picture> <source alt="Nuclear Music Player" srcset="packages/docs/.gitbook/assets/readme-banner.png"> <img alt="Nuclear Music Player" srcset="packages/docs/.gitbook/assets/readme-banner.png"> </picture></p><div align="center"># Nuclear </div><div 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. </div>## 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>| | ||:---:|:---:||  |  || Artist search | Album search ||  |  || Playlists | Plugin store ||  |  || Installed plugins | Preferences ||  |  || What's new | Log viewer |## DownloadGrab the latest release for your platform from
Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add website --env CODECOV_TOKEN=${CODECOV_TOKEN} -- npx -y @nuclearplayer/[email protected]{
"mcpServers": {
"website": {
"command": "npx",
"args": [
"-y",
"@nuclearplayer/[email protected]"
],
"env": {
"CODECOV_TOKEN": "${CODECOV_TOKEN}"
}
}
}
}Exposed tools (70) 42 read · 19 write · 9 destructive
Blast radius: 9 tools can delete or overwrite. An agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
Gruvbox | read | Retro groove color scheme. Based on the classic Vim theme. |
Sakura | read | Cherry blossom |
YoRHa | read | Inspired by the UI of NieR:Automata. |
addAlbum | write | Add an album to favorites. |
addArtist | write | Add an artist to favorites. |
addAt | write | Insert tracks at a specific position. |
addNext | write | Insert tracks immediately after the current item. |
addToQueue | write | Add tracks to the end of the queue. |
addTrack | write | Add a track to favorites. |
addTracks | write | Add tracks to a playlist. Returns the created playlist items. |
clearQueue | destructive | Remove all items from the queue. |
createPlaylist | write | Create a new empty playlist. Returns the playlist ID. |
deletePlaylist | destructive | Delete a playlist by ID. |
fetchAlbumDetails | read | Fetch full album details including track listing. |
fetchArtistAlbums | read | Fetch an artist |
fetchArtistBio | read | Fetch an artist |
fetchArtistPlaylists | read | Fetch playlists associated with an artist. |
fetchArtistRelatedArtists | read | Fetch artists similar to the given artist. |
fetchArtistSocialStats | read | Fetch an artist |
fetchArtistTopTracks | read | Fetch an artist |
fetchEditorialPlaylists | read | Fetch editorial/curated playlists, optionally from a specific provider. |
fetchNewReleases | read | Fetch new album releases, optionally from a specific provider. |
fetchTopAlbums | read | Fetch top/trending albums, optionally from a specific provider. |
fetchTopArtists | read | Fetch top/trending artists, optionally from a specific provider. |
fetchTopTracks | read | Fetch top/trending tracks, optionally from a specific provider. |
get | read | Get a specific provider by ID and kind. |
getAlbums | read | Get all favorite albums. |
getArtists | read | Get all favorite artists. |
getCurrentItem | read | Get the currently playing queue item. |
getGlobal | read | Get the value of any setting by its fully qualified ID |
getIndex | read | Get the list of all playlists with summary info. |
getPlaylist | read | Get a playlist by ID with all its items. |
getQueue | read | Get the current queue state. |
getRepeatMode | read | Get the current repeat mode: |
getState | read | Get the current playback state (status, seek position, duration). |
getTracks | read | Get all favorite tracks. |
getVolume | read | Get the current volume level (0 to 1). |
goToId | read | Jump to a specific queue item by its ID. |
goToIndex | read | Jump to a specific position in the queue. |
goToNext | read | Skip to the next item. |
goToPrevious | read | Go back to the previous item. |
importPlaylist | write | Import a full playlist object. Returns the new playlist ID. |
isAlbumFavorite | read | Check if an album is in favorites. |
isArtistFavorite | read | Check if an artist is in favorites. |
isMuted | read | Check whether audio output is muted. |
isShuffleEnabled | read | Check whether shuffle is enabled. |
isTrackFavorite | read | Check if a track is in favorites. |
list | read | List all registered providers, optionally filtered by kind (metadata, streaming, lyrics, dashboard). |
pause | read | Pause playback. |
play | write | Start or resume playback. |
removeAlbum | destructive | Remove an album from favorites by its provider reference. |
removeArtist | destructive | Remove an artist from favorites by its provider reference. |
removeByIds | destructive | Remove items from the queue by their IDs. |
removeByIndices | destructive | Remove items from the queue by their indices. |
removeTrack | destructive | Remove a track from favorites by its provider reference. |
removeTracks | destructive | Remove items from a playlist by their item IDs. |
reorder | write | Move a queue item from one position to another. |
reorderTracks | write | Move a track within a playlist from one position to another. |
saveQueueAsPlaylist | write | Save the current queue as a new playlist. Returns the playlist ID. |
search | read | Search for artists, albums, tracks, and playlists. |
seekTo | read | Seek to a position in seconds. |
set | write | Set the value of a setting by its namespace-relative ID. The ID is automatically prefixed with the caller namespace. |
setGlobal | write | Set the value of any setting by its fully qualified ID. |
setMuted | read | Mute or unmute audio. |
setRepeatMode | write | Set the repeat mode: |
setShuffleEnabled | write | Enable or disable shuffle. |
setVolume | write | Set the volume level (0 to 1, where 0 is silent and 1 is full volume). |
stop | destructive | Stop playback and reset position. |
toggle | read | Toggle between play and pause. |
updateItemState | write | Update the loading status of a queue item. |
Details
- Source
- nukeop/nuclear
- npm
@nuclearplayer/website@2.12.3- Transports
- streamable-http
- Credentials it reads
CODECOV_TOKEN- License
- AGPL-3.0
- Stars
- 18,456 · pushed 0d ago
Trust audit
Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (5 observation(s))
- Network
- declared (8 observation(s))
- Shell
- declared (3 observation(s))
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (25)
new Function('exports', 'module', 'require', code)(clearQueue, deletePlaylist, removeAlbum, removeArtist, removeByIds, removeByIndices, removeTrack, removeTracks, stop
nuclear-mcp.zip
.node-version
.prettierignore
.gitbook.yaml
import { LoggerProvider } from '../../LoggerProvider';import { useCoreSetting } from '../../hooks/useCoreSetting';import { useProviders } from '../../hooks/useProviders';import { playbackManager } from '../../services/playback';import { useQueueStore } from '../../stores/queueStore';claude mcp add nuclear --transport http http://127.0.0.1:8800/mcp
codex mcp add nuclear --url http://127.0.0.1:8800/mcp
"url": "http://127.0.0.1:8800/mcp"
"url": "http://127.0.0.1:8800/mcp"
Enable Nuclear Jam in Settings, then Integrations. The **API URL** field shows the base URL (e.g. `http://192.168.1.42:4120/api`).
@ianvs/prettier-plugin-sort-imports, @tailwindcss/vite, @vitejs/plugin-react, @vitest/coverage-v8, eslint, husky, jsdom, lint-staged
@eslint/css, @eslint/js, @eslint/json, @eslint/markdown, @ianvs/prettier-plugin-sort-imports, eslint, eslint-config-prettier, eslint-plugin-prettier
hls.js, @testing-library/jest-dom, @testing-library/react, @types/react, @types/react-dom, @vitejs/plugin-react, @vitest/coverage-v8, jsdom
i18next, react-i18next, @types/react, @vitejs/plugin-react, @vitest/coverage-v8, typescript, vite, vite-plugin-dts
zod, @vitest/coverage-v8, typescript, vite, vitest
packages/docs/.gitbook/assets/dashboard-main.png
packages/docs/.gitbook/assets/playlists.png
packages/docs/.gitbook/assets/search-albums.png
packages/docs/.gitbook/assets/search-artists.png
Gates applied: no_behavioural_pass.
Audited 2026-09-16 · audit v0.4.0 · source sha 10f8e40debaa · full audit: observations/trust-audit/mcp-server/nukeop__nuclear.json · Report an issue or request a re-scan
Audit history
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-09-16 | 10f8e40debaa | BLOCK | D | 69 | first audit |
Alternatives
Other servers in the same categories, safer ones first.
Questions
What is the Nuclear MCP server?
Streaming music player that finds free music for you
What tools does Nuclear expose?
70 in total: 42 read-only, 19 that write, and 9 that can delete or overwrite (clearQueue, deletePlaylist, removeAlbum, removeArtist, removeByIds). Every one is listed on this page with its risk.
Is Nuclear safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (69/100) and found 1 critical or high issue in the source. Each one is listed on this page with the file and line it is on. Separately from the audit: 9 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does Nuclear need?
It reads CODECOV_TOKEN from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does Nuclear run?
It speaks streamable-http, so it runs as a service you connect to over the network. It is published on npm as @nuclearplayer/website at 2.12.3.
How current is this page?
The grade is for one exact copy of the source (10f8e40debaa), read on 2026-09-16. The repository is watched and re-audited when it changes.
Provenance: OBSERVED · read 2026-09-16 · job trust-audit-2026-09-16