Servidor MCP de música gratuito

Este es un servidor MCP (Protocolo de Contexto de Modelo) de música gratuito diseñado específicamente para el altavoz inteligente Xiaozhi AI, que ofrece funciones como búsqueda de música y control de reproducción.

Características

• 🎵 Búsqueda de música: Admite búsquedas por nombre de canción o nombre de artista

• ▶️ Control de reproducción: Reproducir, pausar, detener, anterior, siguiente

• 🔊 Control de volumen: Ajuste del volumen de reproducción (0-100)

• 📝 Lista de reproducción: Añadir, ver y vaciar la lista de reproducción

• 🆓 Totalmente gratuito: Basado en una licencia de código abierto, sin costes

• 🔌 Interfaz estándar: Sigue el estándar del protocolo MCP

Instalación y configuración

1. Preparación del entorno

Asegúrese de tener instalado Python 3.8+:

python3 --version

2. Instalación de dependencias

cd /Users/a1234/Documents/music
pip3 install -r requirements.txt

3. Prueba del servidor

python3 music_mcp_server.py

4. Configuración de Xiaozhi AI

Paso 1: Obtener el punto de acceso MCP

1. Inicie sesión en la consola de xiaozhi.me

2. Acceda a la página de configuración de roles del agente

3. Busque el punto de acceso MCP exclusivo para este agente en la esquina inferior derecha

Paso 2: Configurar el servidor MCP

Añada la siguiente configuración en la consola de Xiaozhi AI:

{
  "name": "免费音乐服务器",
  "command": "python3",
  "args": ["/Users/a1234/Documents/music/music_mcp_server.py"],
  "transport": "stdio"
}

Modo de uso

Una vez configurado, puede interactuar con Xiaozhi AI mediante voz o texto:

Búsqueda de música

• "Busca canciones de Jay Chou"

• "Busca algo de música pop"

• "Busca Blue and White Porcelain"

Control de reproducción

• "Reproduce Blue and White Porcelain"

• "Pausa la música"

• "Continúa la reproducción"

• "Detén la música"

• "Siguiente canción"

• "Canción anterior"

Control de volumen

• "Pon el volumen a 80"

• "Baja un poco el volumen"

• "Establece el volumen a 50"

Gestión de listas de reproducción

• "Muestra la lista de reproducción"

• "Añade esta canción a la lista de reproducción"

• "Vacía la lista de reproducción"

Herramientas disponibles

Arquitectura técnica

• Protocolo: MCP (Model Context Protocol)

• Transporte: stdio (entrada/salida estándar)

• Lenguaje: Python 3.8+

• Dependencias: mcp, httpx, pydantic

Desarrollo de extensiones

Conexión a una API de música real

La versión actual utiliza datos simulados; puede modificar la función search_music_api para conectarse a una API de música gratuita real:

async def search_music_api(query: str, limit: int = 10) -> List[Dict[str, Any]]:
    async with httpx.AsyncClient() as client:
        # 接入您选择的免费音乐API
        response = await client.get(
            "https://api.example.com/search",
            params={"q": query, "limit": limit}
        )
        data = response.json()
        return parse_search_results(data)

Añadir nuevas funciones

1. Añada la definición de la nueva herramienta en handle_list_tools()

2. Implemente la lógica de la herramienta en handle_call_tool()

3. Actualice el archivo de configuración y la documentación

Solución de problemas

Preguntas frecuentes

P: El servidor no arranca R: Compruebe que la versión de Python y los paquetes de dependencias estén instalados correctamente

P: Xiaozhi AI no puede conectarse R: Confirme que la ruta del archivo sea correcta y verifique la configuración del punto de acceso MCP

P: No hay resultados de búsqueda R: Actualmente se utilizan datos simulados, puede conectarse a una API de música real

Modo de depuración

Habilitar registros detallados:

PYTHON_LOG_LEVEL=DEBUG python3 music_mcp_server.py

Licencia

Este proyecto es de código abierto bajo la licencia MIT; puede usarlo, modificarlo y distribuirlo libremente.

Contribución

¡Le invitamos a enviar Issues y Pull Requests para mejorar este proyecto!

Nota: Asegúrese de cumplir con las leyes y regulaciones de derechos de autor de música pertinentes, utilizando únicamente recursos musicales legales.