企业官网建设流程全解析

3步接好Nuclear：把免费音乐流媒体播放器变成脚本和AI能直接控制的对象

【免费下载链接】nuclearStreaming music player that finds free music for you项目地址: https://gitcode.com/GitHub_Trending/nu/nuclear

Nuclear 是一个免费、无广告、开源的音乐流媒体播放器，跨 Win/macOS/Linux。这篇写给想用脚本或 AI 驱动播放的开发者：先在本机跑起来，再接上 3 种本地 API。

一、它到底能帮你做什么

• 搜任意歌曲直接流式播放（不用账号、没有广告、无追踪，装完即听）
• 队列、收藏、播放列表全套管理（导入导出、拖拽排序、随机与循环）
• 播放状态能被脚本和 AI 控制（内置 MCP、MPD、HTTP API，全是本地服务）
• 免费音源靠插件商店热插拔（流媒体源、元数据、歌词、仪表盘都能用插件扩展）

二、5分钟跑通第一个数据请求

先说前提：Node >= 22、pnpm >= 9、Rust stable，外加你系统的 Tauri 平台依赖。本篇用到的所有接口都是播放器自带的本地服务，不需要任何第三方密钥或付费 API。

git clone https://gitcode.com/GitHub_Trending/nu/nuclear cd nuclear pnpm install && pnpm dev

终端打印出 Vite 开发地址后，播放器窗口会自动弹出。在顶部搜索框输入任意歌手或歌名回车，就能直接开始流式播放。

不想从源码起项目的话，也可以直接下载官方 release 包安装，接口完全一致。

三、三个高频用法演示

终端里用MPD盯盘

玩家挂在桌面常驻，你想在终端或桌面面板里看状态、切歌的时候：

export MPD_HOST=127.0.0.1 export MPD_PORT=6600 mpc currentsong

输出当前曲目的标题、艺人和播放进度。Nuclear 占住默认端口 6600 时，mpc、ncmpcpp 免配置直连；idle命令还能让客户端实时收到推送，不用写轮询脚本。polybar/waybar 的 MPD 模块也能直接显示正在播放的曲目。

脚本里用HTTP API驱动播放

想把播放暂停、切歌、队列管理接进自己的脚本或面板时：

curl -X POST http://192.168.1.42:4120/api/playback/toggle curl -s -X POST http://192.168.1.42:4120/api/search \ -H 'Content-Type: application/json' -d '{"query":"Neon Cascade"}'

第一条切换播放/暂停，返回 200；第二条搜索曲目，返回 tracks、artists、albums 的 JSON 结果。队列接口支持增删，SSE 事件流实时推送状态变化，做个自定义远控面板只需订阅它。

让AI agent接管播放器

🤖 想让 AI 助手用一句话管你的队列时：

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

说句「找点氛围音乐加进队列」，agent 自己就能完成。MCP server 用分层发现：先list_methods，再method_details，最后call执行，每步只返回小 JSON，上下文不炸。

四、用起来不翻车的几个要点

⚠️ 实操里就那么几个固定的坑，记住即可：

• 端口被占：MCP 和 MPD 在 8800/6600 被占用时会自动依次试 8801-8809、6601-6609，以设置页实际显示的地址为准，别写死。
• MCP/MPD 别的机器连不上：两者都只听 127.0.0.1，远程控制请走 Nuclear Jam 的 HTTP API，它才会绑到局域网地址。
• HTTP API 没反应：它是 Nuclear Jam 的子功能，先到 Settings → Integrations 打开，基址看 API URL 字段。
• macOS 首次启动被拦：应用没有 Apple Developer 签名，右键选 Open；或者执行下面这条命令一次：

sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app

• pnpm dev 起不来：核对 Node >= 22、pnpm >= 9、Rust stable 与 Tauri 平台依赖；Linux 上直接用 Flatpak 最省事。

五、它不能做什么

🙅 边界说清楚：

• 它不管本地 MP3 曲库，定位是搜索式流媒体播放，没有下载和离线缓存能力。
• MPD 协议只覆盖播放控制子集，库浏览和存储的播放列表暂不支持。
• 免费音源全部来自社区插件，版权独占内容不作保证，能听什么看插件商店。

六、接下来可以深入的方向

• MCP 完整工具列表与发现流程：packages/docs/integrations/mcp-server.md
• HTTP API 端点与 SSE 事件参考：packages/docs/integrations/http-api.md
• MPD 支持命令与客户端接入：packages/docs/integrations/mpd-server.md
• 插件系统与开发指南：packages/docs/plugins/plugin-system.md

【免费下载链接】nuclearStreaming music player that finds free music for you项目地址: https://gitcode.com/GitHub_Trending/nu/nuclear