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