https://github.com/hugohow/mcp-music-analysis
Integrate librosa, whisper with LLMs to analyze music audio.
https://github.com/hugohow/mcp-music-analysis
mcp
Last synced: 2 months ago
JSON representation
Integrate librosa, whisper with LLMs to analyze music audio.
- Host: GitHub
- URL: https://github.com/hugohow/mcp-music-analysis
- Owner: hugohow
- License: mit
- Created: 2025-03-16T13:34:43.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-04-01T07:06:48.000Z (2 months ago)
- Last Synced: 2025-04-01T07:16:52.939Z (2 months ago)
- Topics: mcp
- Language: Python
- Homepage:
- Size: 4.26 MB
- Stars: 9
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MCP Music Analysis
This repository contains a **Model Context Provider (MCP)** that uses MCP and [librosa](https://librosa.org/) for audio analysis on audio in local, youtube link, or audio link.
## Usage with Claude Desktop
## Installation
```bash
# Clone repository
git clone [email protected]: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`:
```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
```
## To-Do List
- [x] Add URL to audio file download
- [x] Add YouTube to audio file transformation
- [ ] Experiment with multiple Python environments (testing)
- [ ] Improve installation guide
- [ ] Integrate Whisper for lyrics
- [ ] Implement a Docker solution
## Author
Hugo How-Choong