Skip to main content

\A MCP server with music tools\

Project description

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

alt text alt text

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

To-Do List

  • Add URL to audio file download
  • 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mseep_mcp_music_analysis-0.1.41.tar.gz (3.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mseep_mcp_music_analysis-0.1.41-py3-none-any.whl (3.6 kB view details)

Uploaded Python 3

File details

Details for the file mseep_mcp_music_analysis-0.1.41.tar.gz.

File metadata

File hashes

Hashes for mseep_mcp_music_analysis-0.1.41.tar.gz
Algorithm Hash digest
SHA256 eaec4585accbbb60b195682c6b04ee30e6674a25cf4a73d530f704f483c07c54
MD5 cc66e675f883bbb9b900d1d3ecec369c
BLAKE2b-256 59cab436b2c3f7863935552f29ae739ee91a0363d2f56fc19f6b65569effd9d1

See more details on using hashes here.

File details

Details for the file mseep_mcp_music_analysis-0.1.41-py3-none-any.whl.

File metadata

File hashes

Hashes for mseep_mcp_music_analysis-0.1.41-py3-none-any.whl
Algorithm Hash digest
SHA256 71668d78a64ff08b411c4aec43f85a0e463735de5d82c34f05bd4045d8419b23
MD5 5e2b071e4850b5d4a4408b54efa5e221
BLAKE2b-256 d2686e775a16325933b4d9facca0bba2bb21ccff5990261794e5c3c6964f7fa0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page