Music Analysis

🚀 MCP 音樂分析

本倉庫提供了一個 模型上下文提供程序 (MCP)，藉助 MCP 與 librosa 工具，可對本地音頻、YouTube 鏈接音頻或其他音頻鏈接中的音頻進行分析。

🚀 快速開始

此項目藉助 MCP 和 librosa 實現音頻分析，支持本地音頻文件、YouTube 鏈接以及其他音頻鏈接的分析。以下將詳細介紹安裝和使用方法。

📦 安裝指南

# 克隆倉庫
git clone git@github.com:hugohow/mcp-music-analysis.git
cd mcp-music-analysis

# 創建虛擬環境並安裝依賴
uv venv
source .venv/bin/activate  # Windows用戶：.venv\Scripts\activate
uv pip install -e .

使用 Claude 桌面版

定位配置文件

依據不同的操作系統，配置文件的位置如下：

• macOS：

  ~/Library/Application\ Support/Claude/claude_desktop_config.json
  

• Windows：

  %APPDATA%\Claude\claude_desktop_config.json
  

• Linux：

  ~/.config/Claude/claude_desktop_config.json
  

在你的 claude_desktop_config.json 中添加以下內容：

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

💻 使用示例

基礎用法

以下是 MCP 運行後你可能使用的示例提示。MCP 將理解這些請求並執行相關工具：

你能分析一下 /Users/hugohow-choong/Desktop/sample-6s.mp3 的節奏嗎？
能否告訴我 https://download.samplelib.com/mp3/sample-15s.mp3 的時長？
請計算一下 /path/to/another_audio.mp3 的 MFCC。
什麼是 /path/to/music.wav 文件的頻域中心值？
我想要了解 https://www.youtube.com/watch?v=8HFiFd9vx1c 的音高變化時間點。

📋 待辦事項

• [x] 添加 URL 到音頻文件下載
• [x] 添加 YouTube 到音頻文件轉換
• [ ] 嘗試不同的 Python 環境（測試）
• [ ] 改進安裝指南
• [ ] 集成 Whisper 用於歌詞分析
• [ ] 實現 Docker 解決方案

👨‍💻 作者

Hugo How-Choong