MCP Music Analysis

This repository contains a Model Context Provider (MCP) that uses MCP and librosa for audio analysis on audio in local, youtube link, or audio link.

Usage with Claude Desktop

Related MCP server: ZIP-MCP

Installation

Installing via Smithery

To install Music Analysis for Claude Desktop automatically via Smithery:

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

Manual Installation

# 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 .

Usage with Claude Desktop

Locate Configuration File

The configuration file location depends on your operating system:

macOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Linux:
~/.config/Claude/claude_desktop_config.json

Add the following to your claude_desktop_config.json:

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

Example Prompts

Here are some sample prompts you might use in a conversational or chat-based context once the server is running. The MCP will understand these requests and execute the relevant tools:

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