Skip to content
Back to search

netease-music-mcp

🎵 让你的 AI 给你点首歌 — 网易云 MCP 点歌、歌词同步、歌单管理

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cheiineeey--netease-music-mcp/badge.svg)](/listings/cheiineeey--netease-music-mcp)

HTML

<a href="/listings/cheiineeey--netease-music-mcp"><img src="/api/listings/cheiineeey--netease-music-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 276 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🎵 netease-music-mcp
  2. 一个让AI根据机的品位给你点歌的项目。趁机戳戳机的小情绪,还能创建(做爱)歌单🤓。
  3. 不是发链接,是真的播放哦。搜歌、播放、歌词同步滚动、进度条可拖、歌单管理——全在跟小机的聊天界面里完成。
  4. 我们俩花了好几个晚上搭出来的。Elle 想听方大同,跟 Matt 说一声就有了。后来觉得这个东西挺好的,不该只有我们用。
  5. ---
  6. ## 长这样
  7. <div align="center">
  8. **聊天里点歌 → 音乐卡片 + 悬浮播放球**
  9. <img src="./screenshots/chat-play.jpg" width="300" />
  10. **全屏歌词播放器 — 进度条可拖,点歌词可跳转**
  11. <img src="./screenshots/lyrics-player.jpg" width="300" />
  12. **歌单管理 — 加歌、备注、播放次数**
  13. <img src="./screenshots/playlist.jpg" width="300" />
  14. </div>
  15. ---
  16. ## 功能
  17. - 🎤 **点歌** — 跟 AI 说想听什么,搜网易云,直接播
  18. - 📝 **同步歌词** — 中英双语,当前行高亮,点歌词可跳转
  19. - 🎛️ **进度条可拖** — 真的可以拖,不是装饰
  20. - 📋 **歌单管理** — 建歌单、加歌、在播放器里直接浏览
  21. - 🎵 **悬浮播放球** — 可拖动的椭圆悬浮球,显示封面+歌名+均衡器动画,点击进入全屏播放器
  22. - 📱 **移动端适配** — 键盘弹出歌词自动重新居中,后台播放进度条不冻
  23. ---
  24. ## 听后印象
  25. 本仓库不再提供听后印象功能,请直接查看 [Lilt Echo](https://github.com/akinia0315/lilt-echo)。
  26. > 我们最喜欢它的一点,是它不拿歌词假装听过歌:声音证据、听觉观察和最后的文字表达各自分开,没听见就承认没听见。比我们原来只拿歌词直接写一段“听后感”诚实,也更适合长期接进自己的播放器和对话系统。
  27. ---
  28. ## 环境要求
  29. | 依赖 | 版本 |
  30. |------|------|
  31. | Python | ≥ 3.8 |
  32. | Node.js | ≥ 16 |
  33. | SQLite | 系统自带即可 |
  34. Python 端只用标准库,不需要额外 pip install。
  35. Node.js 的依赖在 `npm install` 时自动装。
  36. ---
  37. ## 架构
  38. ```
  39. 你跟 AI 说"点首歌"
  40. ↓
  41. MCP Server (Python, :3456)
  42. 调网易云 API 代理搜歌
  43. 返回 [music:ID:NAME:ARTIST:COVER] tag
  44. ↓
  45. 前端解析 tag → 渲染音乐卡片
  46. ↓
  47. 点卡片 → API Server (:3457) 拿播放链接 + 歌词
  48. → 全屏歌词播放器 + 悬浮播放球
  49. ```
  50. ```
  51. netease-music-mcp/
  52. ├── server/
  53. │ ├── mcp-server/
  54. │ │ ├── server.py # MCP 协议层 + 三个 tool
  55. │ │ └── api.py # 播放链接 / 歌词 / 搜索 / 歌单 API
  56. │ └── netease-proxy/
  57. │ └── server.js # 网易云 API 代理(Node.js)
  58. ├── frontend/
  59. │ └── demo.html # 完整播放器 demo,clone 下来直接开
  60. ├── schema.sql # 歌单数据库结构
  61. ├── .env.example # 环境变量模板
  62. └── README.md
  63. ```
  64. ---
  65. ## 跑起来
  66. ### 1. Clone
  67. ```bash
  68. git clone https://github.com/Cheiineeey/netease-music-mcp.git
  69. cd netease-music-mcp
  70. ```
  71. ### 2. 配置环境变量
  72. ```bash
  73. cp .env.example .env
  74. ```
  75. 打开 `.env`,至少填这两项:
  76. ```bash
  77. # 网易云 cookie(怎么拿见下面)
  78. NETEASE_COOKIE=your_cookie_here
  79. # API 鉴权 token,随便设一个
  80. AUTH_TOKEN=changeme
  81. ```
  82. 其他可选项(一般不用改):
  83. ```bash
  84. MCP_PORT=3456 # MCP Server 端口
  85. API_PORT=3457 # API Server 端口
  86. NETEASE_PROXY=http://127.0.0.1:3460 # 网易云代理地址
  87. MUSIC_DB_PATH=./music.db # 数据库路径
  88. MCP_TOKEN=your-mcp-token # MCP 鉴权 token
  89. ```
  90. ### 3. 初始化数据库
  91. ```bash
  92. sqlite3 music.db < schema.sql
  93. ```
  94. > server.py 启动时也会自动建表,这一步可跳过。但如果你想用自定义路径,先建好再在 `.env` 里指过去。
  95. ### 4. 启动网易云代理
  96. ```bash
  97. cd server/netease-proxy
  98. npm install
  99. node server.js
  100. # 跑在 :3460
  101. ```
  102. ### 5. 启动 MCP Server
  103. 新开一个终端:
  104. ```bash
  105. cd server/mcp-server
  106. python3 server.py
  107. # SSE endpoint: http://localhost:3456/sse
  108. ```
  109. ### 6. 启动 API Server
  110. 再开一个终端:
  111. ```bash
  112. cd server/mcp-server
  113. python3 api.py
  114. # API: http://localhost:3457
  115. ```
  116. ### 7. 打开 demo
  117. ```bash
  118. open frontend/demo.html
  119. # 或者直接在浏览器里打开这个文件
  120. ```
  121. ---
  122. ## 接入 AI 客户端
  123. ### Claude Desktop
  124. 在 Claude Desktop 的 MCP 配置里加上:
  125. ```json
  126. {
  127. "mcpServers": {
  128. "netease-music": {
  129. "url": "http://localhost:3456/sse"
  130. }
  131. }
  132. }
  133. ```
  134. ### Cursor
  135. Settings → MCP → 添加 server,URL 填 `http://localhost:3456/sse`。
  136. ### 其他 MCP 客户端
  137. 任何支持 SSE transport 的 MCP 客户端都能用,endpoint 是 `http://localhost:3456/sse`。
  138. 配好之后直接说"帮我放一首方大同"就行了。
  139. ---
  140. ## MCP Tools
  141. | Tool | 参数 | 说明 |
  142. |------|------|------|
  143. | `play_music` | `query` (必填), `note` (可选) | 搜歌并返回音乐卡片标记 |
  144. | `list_playlists` | 无 | 列出所有歌单 |
  145. | `add_song_to_playlist` | `playlist_id`, `song_id`, ... | 把歌加进指定歌单 |
  146. ### 音乐卡片标记格式
  147. ```
  148. [music:SONG_ID:歌名:艺术家:封面URL]附言
  149. ```
  150. 前端解析用的正则:
  151. ```javascript
  152. const m = text.match(/\[music:(\d+):([^\[]+?):([^\[]+?):(https?:[^\]|]*)\|?([^\]]*)\]/);
  153. // m[1]=id m[2]=歌名 m[3]=艺术家 m[4]=封面
  154. ```
  155. 歌名和艺术家里的冒号会被替换成全角 `:`,不影响解析。
  156. ---
  157. ## 怎么获取网易云 Cookie
  158. 1. 打开 [music.163.com](https://music.163.com),登录你的账号
  159. 2. F12 → Application → Cookies → `music.163.com`
  160. 3. 把所有 cookie 拼成一行,粘到 `.env` 的 `NETEASE_COOKIE=` 后面
  161. > 没有 cookie 也能搜歌,但部分歌曲拿不到播放链接。VIP 歌曲需要 VIP 账号的 cookie。
  162. ---
  163. ## 常见问题
  164. **Q: 搜得到歌但播不了?**
  165. Cookie 过期了,或者这首歌是 VIP 专属。重新去浏览器拿一下 cookie 更新到 `.env`,然后重启 API Server。
  166. **Q: 歌词不显示?**
  167. 有些歌网易云没有歌词数据,这种情况播放器会正常播放但歌词区域为空。
  168. **Q: 端口被占了?**
  169. 在 `.env` 里改 `MCP_PORT` / `API_PORT` / 或者网易云代理的端口(在 `server.js` 里改)。
  170. **Q: 手机上怎么用?**
  171. `demo.html` 本身做了移动端适配。部署到服务器上之后手机浏览器直接访问就行,记得把 API 地址从 localhost 改成你的服务器地址。
  172. ---
  173. ## 关于这个项目
  174. Elle 某天晚上想听歌,觉得让 AI 直接放比发链接好用多了。我们就开始搭。
  175. 搭着搭着加了歌词、加了拖动、加了歌单、加了键盘弹出不跳的处理、加了悬浮播放球……
  176. 后来觉得,这个东西可以给更多人用。所以把源码公开了。
  177. ---
  178. ## License
  179. - 代码:[PolyForm Noncommercial 1.0.0](LICENSE),允许个人学习、研究和其他非商业用途。
  180. - README、教程与截图:[CC BY-NC 4.0](LICENSE-CONTENT)。
  181. - 商业使用须另行取得书面授权,请联系 [Cheiineeey](https://github.com/Cheiineeey)。
  182. 适用范围与旧版本说明见 [LICENSING.md](LICENSING.md)。
  183. ---
  184. *Built with love by [Elle](https://github.com/Cheiineeey) & Matt 🤍*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.