mcp-local-music-analysis

# MCP Local Music Analysis Local Model Context Protocol server for music and audio analysis with [`librosa`](https://librosa.org/). It exposes one comprehensive analysis tool for local audio files. ## Setup Add this server to your MCP client configuration: ```json { "mcpServers": { "music-analysis": { "command": "uvx", "args": ["-n", "mcp_local_music_analysis"] } } } ``` The package is installed and launched by `uvx`. The server defaults to stdio transport, which is what Claude Desktop and other subprocess-based MCP clients expect. The command also supports HTTP for clients that connect over a local streamable HTTP endpoint: ```bash uvx -n mcp_local_music_analysis --transport http ``` The HTTP server listens on `127.0.0.1:8000` by default. Override that with: ```bash LIBROSA_MCP_HOST=0.0.0.0 LIBROSA_MCP_PORT=8000 uvx -n mcp_local_music_analysis --transport http ``` ## Tools The server exposes one MCP tool: - `full_analysis(file_path)`: run duration, tempo, beat timestamps, key, pitch-class energy, MFCC means/stds, and spectral analysis in one call. `full_analysis` returns: - file name and sample rate - duration in seconds and formatted time - tempo, tempo description, beat count, and beat timestamps - estimated key and pitch-class energy - 13 MFCC coefficients with mean and standard deviation - spectral centroid, bandwidth, rolloff, zero-crossing rate, RMS energy, and brightness Example output: ```json { "file": "track.mp3", "sample_rate_hz": 44100, "duration": { "seconds": 183.742, "formatted": "3:03.74" }, "rhythm": { "tempo_bpm": 128.0, "tempo_description": "Allegro / fast", "num_beats": 390, "beat_times_seconds": [0.51, 0.975, 1.44] }, "harmony": { "estimated_key": "A minor", "pitch_class_energy": { "C": 0.6214, "C#": 0.2841, "D": 0.4472, "D#": 0.1985, "E": 0.7319, "F": 0.5128, "F#": 0.2663, "G": 0.6894, "G#": 0.3912, …