Servidor MCP de NetEase Cloud Music (despliegue en Zeabur)

Permite que Claude.ai (Connector oficial) controle NetEase Cloud Music a través del protocolo MCP: escuchar juntos, buscar canciones, añadir canciones, cambiar de canción, enviar mensajes privados, consultar listas de reproducción.

Arquitectura

Claude.ai (Connector)
  ↓ HTTPS（Streamable HTTP，/mcp 端点）
ncm-mcp 服务（Python FastMCP，本仓库）        ← 公网域名
  ├── 读操作（搜索/歌单/私信/详情）→ ncmapi 服务（NeteaseCloudMusicApi 镜像） ← 内网
  └── 写操作（一起听/切歌/加歌/发私信）→ eapi/weapi 加密 → interface.music.163.com

Dos servicios de Zeabur:

¿Por qué las operaciones de escritura no pasan por la imagen? La imagen de Docker Hub es demasiado antigua, los parámetros de cifrado eapi han caducado, y escuchar juntos/enviar mensajes privados devuelven 400. Por eso las operaciones de escritura se cifran directamente en Python y se conectan directamente a la interfaz oficial.

Related MCP server: mcp_music_server

Requisitos previos

1. Repositorio de GitHub (este repositorio)

2. Una cuenta de NetEase Cloud Music para que la use la IA (la «cuenta principal»); tu propia cuenta es la «cuenta secundaria», síguense mutuamente

3. La Cookie completa de la cuenta principal

Obtener la Cookie

1. Abre music.163.com en el navegador del ordenador e inicia sesión con la cuenta principal

2. F12 → Red (Network) → busca cualquier petición enviada a music.163.com → Encabezados de solicitud → encuentra Cookie: → copia el valor completo

3. ⚠️ Debe ser la cadena completa, no solo MUSIC_U (si solo guardas MUSIC_U, todas las operaciones de escritura devolverán 400)

Pasos de despliegue

1. Subir el código a GitHub

La rama master de este repositorio es el código desplegable; tras modificar localmente, haz git push.

2. Crear un proyecto en Zeabur

Inicia sesión en zeabur.com → crea un nuevo Proyecto.

3. Desplegar el servicio ncmapi (imagen)

Add Service → Docker Image → introduce el nombre de la imagen:

binaryify/netease_cloud_music_api:latest

• Cambia el nombre del servicio a ncmapi

• No es necesario vincular un dominio (intranet para que lo llame ncm-mcp)

4. Desplegar el servicio ncm-mcp (este repositorio)

Add Service → GitHub → selecciona el repositorio Yvine34/ncm-mcp

• Zeabur detectará automáticamente el Dockerfile en la raíz y lo compilará

• Cambia el nombre del servicio a ncm-mcp

5. Configurar las variables de entorno

En Variables del servicio ncm-mcp, añade:

Si http://ncmapi:3000 no conecta, vincula también un dominio al servicio ncmapi y rellena NCM_API con esa URL pública https://dominio.

6. Vincular dominio

Servicio ncm-mcp → Domains → genera/víncula un dominio, obtendrás https://xxx.zeabur.app.

7. Añadir Connector en Claude.ai

Claude.ai → Settings → Connectors → añadir:

• URL: https://xxx.zeabur.app/mcp

• Nombre: NetEase Cloud Music

• Permisos: Always allow

Lista de herramientas

Flujo de uso

Escuchar juntos

1. Tú (cuenta secundaria) envías una invitación de escuchar juntos a la cuenta principal en la app de NetEase Cloud Music

2. Dile a Claude «me ha enviado una invitación de escuchar juntos por mensaje privado»

3. Claude llama a get_private_list / get_private_messages para leer los mensajes privados y extrae roomId, inviterId

4. Claude llama a accept_listen_together para unirse a la sala

5. El hilo en segundo plano envía latidos automáticamente cada 60s, la sala no caduca

Pedir canciones

1. Dile a Claude qué quieres escuchar

2. Claude llama a search_music para buscar la canción y obtener el id

3. Claude llama a add_song para añadir la canción

4. Cierra la app una vez y vuelve a entrar para sincronizar la lista

5. Después, Claude usa play_command para cambiar de canción en cualquier momento, con efecto en tiempo real

Enviar mensajes privados

Claude llama a send_private_message para enviar mensajes privados directamente (weapi/RSA; esta parte no se ha probado con una cookie real, la primera vez que se use hay que verificarla).

Preguntas frecuentes

• Todas las operaciones de escritura devuelven 400: la Cookie está incompleta, vuelve a capturar la cadena completa (incluye __csrf, MUSIC_U, MUSIC_A_T, MUSIC_R_T).

• El Connector no conecta: confirma que ncm-mcp tiene un dominio vinculado y que la URL es https://dominio/mcp (termina con /mcp).

• Las operaciones de lectura dan error: confirma que NCM_API es accesible (el servicio ncmapi está en ejecución).

• La sala de escuchar juntos se cae: es normal, pide a Claude que vuelva a llamar a accept_listen_together; el latido automático solo actúa en salas ya aceptadas.