NetEase Together MCP (POC)

一个轻量的网易云音乐“一起听”远程 MCP 验证工程。它使用单独的网易云小号创建官方一起听房间，生成邀请链接，并在后台维持心跳、同步歌单和发送播放指令。

当前状态：代码与模拟测试版。网易云接口属于非公开接口，首次使用必须用小号进行实机验证，不能承诺长期稳定。

能做什么

• 检查小号登录状态

• 搜歌、查看小号歌单、读取歌单歌曲

• 创建私密或公开歌单，向其中添加或移除歌曲

• 创建官方“一起听”房间并生成 iPhone 可点击的邀请链接

• 后台维持房间心跳

• 替换房间歌单，或直接从小号歌单创建房间

• 播放、暂停、跳转歌曲、调整进度

• 查看房间与歌单状态

• 结束房间

邀请链接默认由 ChatGPT 返回，用户点击后用网易云 App 加入。只有在用户明确确认收件人及消息内容后，才可调用 send_listen_together_invitation，从部署者配置的小号发送网易云站内私信；创建房间本身不会自动发送邀请。

Related MCP server: CloudMusic Desktop MCP

安全原则

• 只用无重要资产的小号。

• 不要把密码或 Cookie 发进聊天、Issue、GitHub 仓库。

• .env 已被 Git 忽略，Cookie 仅通过运行环境注入。

• 云端启动必须设置 MCP_AUTH_TOKEN。

• compose.yaml 默认只监听服务器本机的 127.0.0.1:3456，应再通过带 HTTPS 的反向代理或安全隧道发布。

• 所有创建房间、发送邀请、控制播放和改歌单工具都要求 confirm=true。

账号与邀请对象（部署者及 AI 必读）

• 本项目没有默认的个人主号或邀请收件人。仓库作者不等于当前用户，也不是邀请对象。

• 查询个人主页时，使用当前用户提供或核实的账号 ID，不要照抄旧版本、示例或其他会话中的账号。

• 发送邀请前，先核对收件人的公开主页，向当前用户确认具体收件人及消息内容，再传入 confirm=true；无法确定收件人时应先询问，不能猜测。

• 测试文件中的账号 ID 均为虚构占位值，不得用于实机发送邀请。

• 从旧版本升级后，请重启 MCP 服务，并在客户端刷新工具说明；同时检查自建提示词、旧示例或缓存中是否仍残留固定的个人账号指引。仅更新 GitHub 文件不会自动更新已部署的服务或他人的副本。

本地首次验证（Windows）

需要安装 Node.js 20 或更高版本。PowerShell 中进入项目目录后：

Copy-Item .env.example .env
npm install --ignore-scripts
npm test
$env:HOST="127.0.0.1"
$env:ALLOW_INSECURE_LOCAL="true"
$env:NETEASE_COOKIE="从你自己的浏览器本地复制，勿发给别人"
npm start

健康检查地址：http://127.0.0.1:3456/health；MCP 地址：http://127.0.0.1:3456/mcp。

第一次测试只需验证：账户状态 → 创建房间 → iPhone 点击邀请链接 → 加入 → 播放/暂停 → 保持十分钟 → 结束房间。

Windows 云服务器一键更新

服务器首次部署完成后，在管理员 PowerShell 中运行：

powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:\netease-together-mcp\scripts\update-windows.ps1

脚本会下载 GitHub main 分支的最新版，在临时目录安装依赖并运行测试；全部通过后才会替换当前版本并重启 MCP。若已安装安全隧道客户端，脚本也会自动启动或重启它。服务器本地的 .env（包括网易云 Cookie）会被保留，不会上传到 GitHub。若新版本启动失败，脚本会自动恢复并重启旧版本。

一起听历史默认保存在项目目录之外的 %ProgramData%\netease-together-mcp-data\listen-history.json，更新版本不会删除。也可以通过 LISTEN_HISTORY_FILE 指定其他服务器私有路径。

每次成功更新会在 C:\ 保留一个带时间戳的回滚副本。确认新版稳定后，可手动删除旧的 C:\netease-together-mcp.backup-* 目录。新增或重命名 MCP 工具后，还需要在 ChatGPT 的 wyy 插件详情中点击“刷新”，让 ChatGPT 重新读取工具列表。

不敲命令的本地控制台

如果只是本机创建和关闭房间，运行：

npm.cmd run panel

随后浏览器访问 http://127.0.0.1:3457。页面会显示邀请链接，并提供“创建房间”和“关闭房间”按钮。这个页面只监听本机，不能在公网访问。

Docker 部署

生成随机令牌并写入 .env，随后：

docker compose up -d --build

不要把 3456 端口直接暴露到公网。正式远程接入前，需要配置 HTTPS 反向代理或受保护的隧道。

MCP 工具

• netease_account_status

• search_netease_songs

• get_netease_song_details

• get_netease_user_profile

• list_listen_together_history

• save_listen_together_memory

• list_small_account_playlists

• get_netease_playlist_tracks

• create_small_account_playlist

• add_tracks_to_small_account_playlist

• remove_tracks_from_small_account_playlist

• create_listen_together_room

• create_listen_together_from_playlist

• send_listen_together_invitation

• get_listen_together_session

• check_listen_together_room

• replace_listen_together_playlist

• control_listen_together_playback

• close_listen_together_room

技术来源

本 POC 的整体思路参考 Vael-KY/netease-music-mcp，一起听接口通过 MIT 许可的 NeteaseCloudMusicApiEnhanced/api-enhanced 包调用。本项目本身不包含网易云账号凭据。

已知限制

• 私有接口可能随网易云更新而失效。

• 云服务器 IP 与常用登录地区差异过大时，Cookie 可能失效或触发风控。

• 后台服务负责技术上的心跳和控制；模型不会持续接收或听见音频。

• ChatGPT 手机端能否直接显示自建 MCP，需要在同一账号完成远程连接后实机验证。