Nuclear 音乐播放器
让用户或 AI 助手搜索、播放和管理免费音乐。
- Star 数
- ★ 19k
- 最近更新
- 1 天前
- License
- AGPL-3.0
- 主语言
- TypeScript
- FA 评分
- 53/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 希望在 Windows、macOS 或 Linux 上使用无广告、无跟踪播放器，并搜索和播放免费音乐的个人用户。
- 不适合
- 需要完全离线使用的用户：搜索与播放依赖网络和流媒体源插件
- 希望开箱即用、不愿配置 Node.js、pnpm、Rust 与 Tauri 依赖的团队
- 需要多用户或远程部署的场景：MCP 仅提供本机回环端点且无认证
这个 Agent 能做什么，适合哪些场景？
Nuclear 是一款无广告、无跟踪的开源桌面音乐播放器，可在 Windows、macOS 和 Linux 上运行。它能够搜索歌曲、艺人和专辑，通过插件提供的来源播放音乐，并管理队列、收藏与歌单。主应用采用 Tauri 构建，桌面层结合 Rust、React 和 TypeScript；项目则是由 pnpm 与 Turborepo 管理的 monorepo。内置插件商店允许安装提供流媒体来源、元数据、歌单或首页内容的扩展，也可以使用 @nuclearplayer/plugin-sdk 编写插件。启用本地 HTTP MCP 服务器后，Codex CLI、Claude Code、Claude Desktop、Cursor、Windsurf 或 OpenCode 等 MCP 客户端可以驱动播放器。它的部署边界是用户自己的桌面设备，MCP 默认通过 127.0.0.1:8800/mcp 暴露控制接口。
用户在桌面应用中搜索歌曲、艺人或专辑；Nuclear 通过已安装插件提供的流媒体来源和元数据返回结果，并将选中的曲目送入播放队列。播放器可以执行播放、随机播放、重复播放和拖放排序，还能保存曲目、专辑与艺人收藏，以及创建、导入或导出歌单。艺人页面展示简介、唱片目录和相似艺人，专辑页面展示曲目列表。插件商店负责浏览和安装扩展，而 @nuclearplayer/plugin-sdk 用于开发自定义插件。启用 Settings → Integrations 中的 MCP server 后，兼容客户端通过 http://127.0.0.1:8800/mcp 发现并调用播放器能力；操作结果体现在本机 Nuclear 应用的播放状态、队列、收藏或歌单中。
- 希望在 Windows、macOS 或 Linux 上使用无广告、无跟踪播放器，并搜索和播放免费音乐的个人用户。
- 需要整理收藏、创建歌单，以及从其他服务导入歌单的重度音乐听众。
- 希望通过 Codex CLI 或 Claude Code 控制桌面播放器，把选歌和播放操作纳入 AI 工作流的开发者。
- 希望为 Nuclear 增加流媒体来源、元数据、歌单或首页内容的插件开发者。
- 需要在局域网其他设备上打开远程控制界面的开发者，可使用 pnpm dev:remote 将 Vite 绑定到 0.0.0.0。
如何安装或部署这个 Agent？
普通用户可从 GitHub Releases 下载对应平台的软件包：Windows 提供 .exe 安装程序和 .msi，macOS 提供适用于 Apple Silicon 与 Intel 的 .dmg，Linux 提供 .AppImage、.deb、.rpm 和 .flatpak。源码开发需要 Node.js 22 或更高版本、pnpm 9 或更高版本、稳定版 Rust，以及对应平台的 Tauri 依赖。执行：
git clone https://github.com/nukeop/nuclear.git
cd nuclear
pnpm install
pnpm dev无需文档所述的 API 凭据。播放在线音乐需要网络连接。
如何使用这个 Agent？
启动 Nuclear 后，可搜索歌曲或艺人、打开艺人与专辑页面、创建歌单并开始播放。若要让 AI 客户端控制播放器，先在 Settings → Integrations 启用 MCP server。Codex CLI 使用：
codex mcp add nuclear --url http://127.0.0.1:8800/mcpClaude Code 使用：
claude mcp add nuclear --transport http http://127.0.0.1:8800/mcpOpenCode 可配置一个 type 为 remote、url 为 http://127.0.0.1:8800/mcp 的 nuclear 条目；Claude Desktop、Cursor 和 Windsurf 可在 mcpServers 中添加同一 URL。MCP 被描述为可自动发现能力，也可加载仓库提供的 Nuclear MCP Skill 来补充客户端上下文。
这个 Agent 有哪些优点和局限？
- 同一桌面应用覆盖 Windows、macOS 和 Linux，并为各平台提供多种发行包格式。
- 本地 MCP 服务器采用 HTTP 接口，文档明确给出 Codex CLI、Claude Code、OpenCode、Claude Desktop、Cursor 和 Windsurf 的连接配置。
- 插件系统不仅替换流媒体来源，还可提供元数据、歌单和首页内容，并配有内置插件商店与 @nuclearplayer/plugin-sdk。
- 具备搜索、播放队列、收藏、歌单导入导出、主题、快捷键和多语言等完整播放器功能。
- 产品明确声明无广告、无跟踪，并以 AGPL-3.0 发布。
- 播放能力依赖可用的网络连接和已安装插件所提供的音乐来源；来源不可用时可能影响搜索或播放。
- 从源码开发的环境成本较高，需要 Node.js、pnpm、Rust 以及平台专用的 Tauri 依赖。
- MCP 控制必须先在正在运行的桌面应用中手动启用，文档只给出本机 127.0.0.1 地址，没有说明远程部署、认证或多用户访问方式。
- AGPL-3.0 对修改、分发或网络使用场景可能带来合规义务，采用前需要评估。
- 来源没有列出具体默认流媒体提供方、曲库覆盖范围或服务可用性保证。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Nuclear 音乐播放器 当前 | 53 · 缺口较多 | 桌面应用免费 | ★ 19k | 1 天前 | TypeScript | Codex · Claude Code |
| AIBot：Minecraft 自主玩家 | 83 · 表现良好 | 自托管服务免费 + 模型费 | ★ 161 | 1 个月前 | Java | OpenAI API |
| Filtmall 智能购物 | 证据不足 | Agent 插件 / 技能 | ★ 974 | 1 个月前 | JavaScript | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
MCP 服务需要用户在设置中显式启用，并绑定到回环地址，体现了适当的默认权限边界和用户确认。README 声称无广告、无追踪，但未提供隐私说明、敏感数据生命周期、遥测实现或流媒体及插件数据流清单。冻结锁文件安装和 CI 提供有限的供应链控制，但没有依赖审计、漏洞处置或插件审查证据。播放、队列、收藏、播放列表和插件可产生外部或持久化效果，却未说明逐操作确认、效果预览或恢复机制。作者、仓库、社区渠道和许可证有明确归属，但维护者身份未经企业注册表验证，故不据此推断额外可信度。
README、package.json 和 CI 对 pnpm、Turborepo、测试、构建及主要技术栈的描述基本一致。平台包、明确的工具版本、前置条件和冻结锁文件使依赖获取路径较清楚，但外部音乐源和插件的可用性、降级策略及兼容性保证没有说明。测试辅助代码覆盖 HTTP 错误、挂起、取消和损坏响应场景，并构造了具体错误文本，但没有给出面向用户或 MCP 调用者的完整错误语义、重试策略和恢复指引。
文档清楚面向桌面音乐用户、插件开发者以及希望通过 Claude Code、Codex CLI、OpenCode 等控制播放器的用户，并覆盖三类桌面系统。MCP 被描述为可发现，但没有提供工具清单、参数模式、只读与写入边界、授权范围或精确触发规则，因此能力边界和触发精度只能获得有限分。Windows、macOS、Linux 的发行格式以及开发环境要求记录得很完整，环境适配证据充分。
README 以截图、下载、功能、插件、MCP、开发、社区和许可证组织信息，结构清楚；安装格式、开发前置条件、启动及验证命令完整。Nuclear、包作用域和命令命名较一致，但根包版本为 0.0.10，且没有稳定性政策。多个 MCP 客户端配置示例具有实用性，但没有 FAQ。没有已知限制章节。AGPL-3.0-only 元数据、README 声明和完整许可证正文相互吻合，值得满分。仅有 What's new 功能截图和发布准备脚本线索，未提供实际变更日志或版本政策；维护渠道存在，但责任人、支持承诺和安全报告路径不明确。
截图和功能说明显示了可直接使用的搜索、播放、队列、播放列表、主题、插件和日志界面，MCP 又为代理控制提供额外价值。跨来源搜索、插件扩展和桌面集成相对普通播放器具有合理增量价值。软件免费且开源，用户成本较低，但依赖第三方流媒体源、插件生态及本地桌面运行，潜在法律、可用性、安全和维护成本没有量化，因此未达到充分论证。
部分开发声明可追溯到 package.json、CI 和测试辅助代码，平台与界面声明也配有截图，但核心的 MCP 工具行为、无追踪声明、插件权限和音乐来源机制缺少对应实现证据。不同文件对技术栈、命令、许可证及测试流程形成一定交叉印证。宣传性功能陈述与可验证事实未被系统区分，也没有逐项证据映射或明确标注推断，因此可验证性仍有限。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 启用 MCP 前，应检查实际工具清单及其读写权限；所给材料没有说明代理能否修改或删除队列、收藏、播放列表或插件状态。
- “无追踪”声明缺少隐私政策或实现证据；应独立核查遥测、日志、搜索查询、流媒体请求和插件通信。
- 内置插件商店和第三方音乐源扩大供应链及数据暴露面，但材料没有展示插件审核、权限隔离、签名或撤销机制。
- 未记录撤销、备份或恢复流程；在允许代理执行持久化操作前，应先使用可恢复的数据或隔离配置。
- dev:remote 会绑定到 0.0.0.0；仅应在受信任网络上使用，并核查认证和访问控制。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
[email protected] Nuclear Player v1.51.2
发布说明摘录
What's New in v1.51.2 - Fix: Fixed silent YouTube playback on Linux. The AppImage now bundles the GStreamer libav plugin, and the AUR, .deb, and .rpm packages require it. Linux - @nukeop - Fix: Listening history no longer records a track twice when the previous track ends on its own History - @nukeop > macOS: If the app won't open, run sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app in Terminal.在 GitHub 查看 ↗ -
[email protected] Nuclear Player v1.51.1
发布说明摘录
Nuclear Player release v1.51.1 > macOS: If the app won't open, run sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app in Terminal.在 GitHub 查看 ↗ -
[email protected] Nuclear Player v1.51.0
发布说明摘录
What's New in v1.51.0 - Feature: Nuclear Jam shows lyrics now. Tap the microphone button to open the lyrics page Lyrics Integrations - @nukeop > macOS: If the app won't open, run sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app in Terminal.在 GitHub 查看 ↗