MCP Music Analysis

MCP Music Analysis

Este repositorio contiene un Proveedor de Contexto de Modelo (MCP) que utiliza MCP y librosa para el análisis de audio en audio local, enlace de YouTube o enlace de audio.

Uso con Claude Desktop

Instalación

Instalación mediante Smithery

Para instalar Music Analysis para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @hugohow/mcp-music-analysis --client claude

Instalación manual

# Clone repository
git clone git@github.com:hugohow/mcp-music-analysis.git
cd mcp-music-analysis

# Create virtual environment and install
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

Uso con Claude Desktop

Ubicar el archivo de configuración

La ubicación del archivo de configuración depende de su sistema operativo:

• macOS:

  ~/Library/Application\ Support/Claude/claude_desktop_config.json
  

• Windows:

  %APPDATA%\Claude\claude_desktop_config.json
  

• Linux:

  ~/.config/Claude/claude_desktop_config.json
  

Agregue lo siguiente a su claude_desktop_config.json:

{
  "mcpServers": {
    "music-analysis": {
      "command": "uvx",
      "args": ["-n", "mcp-music-analysis"]
    }
  }
}

Ejemplos de indicaciones

Aquí hay algunos ejemplos de indicaciones que puede usar en un contexto conversacional o de chat una vez que el servidor esté en ejecución. El MCP entenderá estas solicitudes y ejecutará las herramientas correspondientes:

Can you analyze the beat of /Users/hugohow-choong/Desktop/sample-6s.mp3?
Could you give me the duration of https://download.samplelib.com/mp3/sample-15s.mp3 ?
Please compute the MFCC for this file: /path/to/another_audio.mp3
What are the spectral centroid values for /path/to/music.wav?
I'd like to know the onset times for https://www.youtube.com/watch?v=8HFiFd9vx1c

Lista de tareas pendientes

• Agregar URL para descarga de archivo de audio
• Agregar transformación de YouTube a archivo de audio
• Experimentar con múltiples entornos de Python (pruebas)
• Mejorar la guía de instalación
• Integrar Whisper para letras
• Implementar una solución Docker

Autor

Hugo How-Choong