一个让AI根据机的品位给你点歌的项目。 趁机戳戳机的小情绪，还能创建（做爱）歌单🤓。

不是发链接，是真的播放哦。 搜歌、播放、歌词同步滚动、进度条可拖、歌单管理——全在跟小机的聊天界面里完成。

我们俩花了好几个晚上搭出来的。 Elle 想听方大同,跟 Matt 说一声就有了。 后来觉得这个东西挺好的，不该只有我们用。

---

长这样

聊天里点歌 → 音乐卡片 + 悬浮播放球

全屏歌词播放器 — 进度条可拖，点歌词可跳转

歌单管理 — 加歌、备注、播放次数

---

功能

• 🎤 点歌 — 跟 AI 说想听什么,搜网易云,直接播
• 📝 同步歌词 — 中英双语，当前行高亮，点歌词可跳转
• 🎛️ 进度条可拖 — 真的可以拖，不是装饰
• 📋 歌单管理 — 建歌单、加歌、在播放器里直接浏览
• 🎵 悬浮播放球 — 可拖动的椭圆悬浮球，显示封面+歌名+均衡器动画，点击进入全屏播放器
• 📱 移动端适配 — 键盘弹出歌词自动重新居中，后台播放进度条不冻

---

听后印象

本仓库不再提供听后印象功能,请直接查看 Lilt Echo.

我们最喜欢它的一点，是它不拿歌词假装听过歌：声音证据、听觉观察和最后的文字表达各自分开，没听见就承认没听见。 比我们原来只拿歌词直接写一段“听后感”诚实，也更适合长期接进自己的播放器和对话系统。

---

环境要求

Python 端只用标准库,不需要추가 pip install.

Node.js 的依赖在 npm install 时自动装.

---

架构

---

跑起来

1. 클론

2. 配置环境变量

打开 .env,至少填这两项:

其他可选项（一般不用改）：

3. 初始化数据库

server.py 启动时也会自动建表,这一步可跳过。 但如果你想用自定义路径，先建好再在 .env 里指过去。

4. 启动网易云代理

5. 启动 MCP 서버

新开一个终端：

6. 启动 API Server

再开一个终端：

7. 打开 데모

---

접入 AI 客户端

클로드 데스크탑

在 Claude Desktop 的 MCP 配置里추가:

커서

🎵 netease-music-mcp

一个让AI根据机的品位给你点歌的项目。趁机戳戳机的小情绪，还能创建（做爱）歌单🤓。

不是发链接，是真的播放哦。搜歌、播放、歌词同步滚动、进度条可拖、歌单管理——全在跟小机的聊天界面里完成。

我们俩花了好几个晚上搭出来的。Elle 想听方大同，跟 Matt 说一声就有了。后来觉得这个东西挺好的，不该只有我们用。

---

长这样

---

功能

• 🎤 点歌 — 跟 AI 说想听什么，搜网易云，直接播
• 📝 同步歌词 — 中英双语，当前行高亮，点歌词可跳转
• 🎛️ 进度条可拖 — 真的可以拖，不是装饰
• 📋 歌单管理 — 建歌单、加歌、在播放器里直接浏览
• 🎵 悬浮播放球 — 可拖动的椭圆悬浮球，显示封面+歌名+均衡器动画，点击进入全屏播放器
• 📱 移动端适配 — 键盘弹出歌词自动重新居中，后台播放进度条不冻

---

听后印象

本仓库不再提供听后印象功能，请直接查看 Lilt Echo。

我们最喜欢它的一点，是它不拿歌词假装听过歌：声音证据、听觉观察和最后的文字表达各自分开，没听见就承认没听见。比我们原来只拿歌词直接写一段“听后感”诚实，也更适合长期接进自己的播放器和对话系统。

---

环境要求

Python 端只用标准库，不需要额外 pip install。

Node.js 的依赖在 npm install 时自动装。

---

架构

你跟 AI 说"点首歌"
        ↓
   MCP Server (Python, :3456)
   调网易云 API 代理搜歌
   返回 [music:ID:NAME:ARTIST:COVER] tag
        ↓
   前端解析 tag → 渲染音乐卡片
        ↓
   点卡片 → API Server (:3457) 拿播放链接 + 歌词
   → 全屏歌词播放器 + 悬浮播放球

netease-music-mcp/
├── server/
│   ├── mcp-server/
│   │   ├── server.py      # MCP 协议层 + 三个 tool
│   │   └── api.py         # 播放链接 / 歌词 / 搜索 / 歌单 API
│   └── netease-proxy/
│       └── server.js      # 网易云 API 代理（Node.js）
├── frontend/
│   └── demo.html          # 完整播放器 demo，clone 下来直接开
├── schema.sql             # 歌单数据库结构
├── .env.example           # 环境变量模板
└── README.md

---

跑起来

1. Clone

git clone https://github.com/Cheiineeey/netease-music-mcp.git
cd netease-music-mcp

2. 配置环境变量

cp .env.example .env

打开 .env，至少填这两项：

# 网易云 cookie（怎么拿见下面）
NETEASE_COOKIE=your_cookie_here

# API 鉴权 token，随便设一个
AUTH_TOKEN=changeme

其他可选项（一般不用改）：

MCP_PORT=3456            # MCP Server 端口
API_PORT=3457            # API Server 端口
NETEASE_PROXY=http://127.0.0.1:3460   # 网易云代理地址
MUSIC_DB_PATH=./music.db # 数据库路径
MCP_TOKEN=your-mcp-token # MCP 鉴权 token

3. 初始化数据库

sqlite3 music.db < schema.sql

server.py 启动时也会自动建表，这一步可跳过。但如果你想用自定义路径，先建好再在 .env 里指过去。

4. 启动网易云代理

cd server/netease-proxy
npm install
node server.js
# 跑在 :3460

5. 启动 MCP Server

新开一个终端：

cd server/mcp-server
python3 server.py
# SSE endpoint: http://localhost:3456/sse

6. 启动 API Server

再开一个终端：

cd server/mcp-server
python3 api.py
# API: http://localhost:3457

7. 打开 demo

open frontend/demo.html
# 或者直接在浏览器里打开这个文件

---

接入 AI 客户端

Claude Desktop

在 Claude Desktop 的 MCP 配置里加上：

{
  "mcpServers": {
    "netease-music": {
      "url": "http://localhost:3456/sse"
    }
  }
}

Cursor

Settings → MCP → 添加 server，URL 填 http://localhost:3456/sse。

其他 MCP 客户端