MCP Music Analysis

🚀 MCP 音樂分析

此倉庫包含一個 模型上下文提供程序（MCP），它藉助 MCP 和 librosa 對音頻進行分析。該程序支持分析本地文件、YouTube 鏈接或音頻鏈接的音頻內容，為音樂分析提供了便利。

🚀 快速開始

安裝指南

使用 Smithery 進行自動安裝

可通過 Smithery 自動安裝適用於 Claude Desktop 的音樂分析工具：

npx -y @smithery/cli install @hugohow/mcp-music-analysis --client claude

手動安裝

# 克隆倉庫
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 Desktop 配合使用

定位配置文件

配置文件的位置因操作系統而異：

• 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 運行時可能用到的示例提示，展示了用戶可能的查詢方式：

你能分析一下 /Users/hugohow-choong/Desktop/sample-6s.mp3 的節奏嗎？
可以提供一下 https://download.samplelib.com/mp3/sample-15s.mp3 的持續時間嗎？
請計算一下這個文件的 MFCC：/path/to/another_audio.mp3
什麼是 music.wav 文件的頻譜質心值？
我想要了解 https://www.youtube.com/watch?v=8HFiFd9vx1c 的節奏起始時間。

✨ 主要特性

• 支持對本地文件、YouTube 鏈接或音頻鏈接的音頻進行分析。
• 具備 URL 到音頻文件下載功能。
• 可將 YouTube 內容轉換為音頻文件。

📄 待辦事項

• [x] 添加 URL 到音頻文件下載功能
• [x] 添加 YouTube 到音頻文件轉換
• [ ] 測試多個 Python 環境
• [ ] 改進安裝指南
• [ ] 集成 Whisper 進行歌詞分析
• [ ] 實現 Docker 解決方案

📄 作者

Hugo How - Choong

倉庫徽章