Skip to main content
Glama
mcp-audio-analysis

mcp-audio-analysis

by hugohow

MCP 음악 분석

대장간 배지

이 저장소에는 로컬 오디오, YouTube 링크 또는 오디오 링크에 대한 오디오 분석을 위해 MCP와 librosa를 사용하는 모델 컨텍스트 공급자(MCP)가 포함되어 있습니다.

Claude Desktop과 함께 사용

Related MCP server: multimodal-reader-mcp

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Music Analysis를 자동으로 설치하려면:

지엑스피1

수동 설치

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

Claude Desktop과 함께 사용

구성 파일 찾기

구성 파일 위치는 운영 체제에 따라 다릅니다.

  • 맥OS :

    ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • 윈도우 :

    %APPDATA%\Claude\claude_desktop_config.json
  • 리눅스 :

    ~/.config/Claude/claude_desktop_config.json

claude_desktop_config.json 에 다음을 추가하세요.

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

예시 프롬프트

서버가 실행되면 대화형 또는 채팅 기반 환경에서 사용할 수 있는 몇 가지 샘플 프롬프트가 있습니다. MCP는 이러한 요청을 이해하고 관련 도구를 실행합니다.

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

할 일 목록

  • [x] 오디오 파일 다운로드에 URL 추가

  • [x] YouTube를 오디오 파일 변환에 추가

  • [ ] 다양한 Python 환경으로 실험(테스트)

  • [ ] 설치 가이드 개선

  • [ ] 가사에 Whisper 통합

  • [ ] Docker 솔루션 구현

작가

휴고 하우충

Available Tools

8 tools
beat_trackB
Computes the beat track of the given audio time series using librosa.
The beat track is a representation of the audio signal in terms of its
rhythmic content, which is useful for music analysis.
The beat track is computed using the following parameters:
- hop_length: The number of samples between frames.
- start_bpm: The initial estimate of the tempo (in BPM).
- tightness: The tightness of the beat tracking (default is 100).
- units: The units of the beat track (default is "frames"). It can be frames, samples, time.

Inputs: path_audio_time_series_y (required), hop_length, start_bpm, tightness, +1 more.

chroma_cqtA
Computes the chroma CQT of the given audio time series using librosa.
The chroma CQT is a representation of the audio signal in terms of its
chromatic content, which is useful for music analysis.
The chroma CQT is computed using the following parameters:
- path_audio_time_series_y: The path to the audio time series (CSV file).
    It's sometimes better to take harmonics only
- hop_length: The number of samples between frames.
- fmin: The minimum frequency of the chroma feature.
- n_chroma: The number of chroma bins (default is 12).
- n_octaves: The number of octaves to include in the chroma feature.
The chroma CQT is saved to a CSV file with the following columns:
- note: The note name (C, C#, D, etc.).
- time: The time position of the note in seconds.
- amplitude: The amplitude of the note at that time.
The path to the CSV file is returned.

Inputs: path_audio_time_series_y (required), hop_length, fmin, n_chroma, +1 more.

download_from_urlC

Downloads a file from a given URL and returns the path to the downloaded file. Be careful, you will never know the name of the song.

Inputs: url (required).

download_from_youtubeC

Downloads a file from a given youtube URL and returns the path to the downloaded file. Be careful, you will never know the name of the song.

Inputs: youtube_url (required).

get_durationC

Returns the total duration (in seconds) of the given audio time series.

Inputs: path_audio_time_series_y (required).

loadB

Loads an audio file and returns the path to the audio time series Offset and duration are optional, in seconds. Be careful, you will never know the name of the song.

Inputs: file_path (required), offset, duration.

mfccC
Computes the MFCC of the given audio time series using librosa.
The MFCC is a representation of the audio signal in terms of its
spectral content, which is useful for music analysis.
The MFCC is computed using the following parameters:
- path_audio_time_series_y: The path to the audio time series (CSV file).
    It's sometimes better to take harmonics only

Inputs: path_audio_time_series_y (required).

tempoC

Estimates the tempo (in BPM) of the given audio time series using librosa. Offset and duration are optional, in seconds.

Inputs: path_audio_time_series_y (required), hop_length, start_bpm, std_bpm, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools have distinct purposes in audio analysis (e.g., beat tracking vs. chroma vs. MFCC), but download_from_url and download_from_youtube overlap significantly in function—both download audio files from different sources with similar descriptions. The core analysis tools are well-differentiated, but the download tools could cause confusion.

    Naming Consistency3/5

    The naming is mixed: some tools use descriptive verb_noun patterns (beat_track, get_duration), while others are single verbs (load, tempo) or noun phrases (chroma_cqt, mfcc). There's no consistent convention across all tools, though most names are readable and hint at their function.

    Tool Count4/5

    With 8 tools, the count is reasonable for an audio analysis server, covering key operations like loading, downloading, and various analysis features. It's slightly lean but not incomplete, as it includes essential functions without being overwhelming.

    Completeness3/5

    The server covers basic audio analysis tasks (loading, downloading, duration, tempo, spectral features), but there are notable gaps: no tools for editing, filtering, or exporting audio, and no way to visualize results. The analysis tools are focused on computation but lack broader workflow support.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers