🚀 MCP 音乐分析
本项目提供了一个 模型上下文提供程序（MCP），借助 MCP 和 librosa 对音频进行全面分析。它支持本地文件、YouTube 链接或音频链接等多种输入方式，为音乐分析带来了极大的便利。
🚀 快速开始
此仓库包含的模型上下文提供程序，能让你轻松对音频进行分析。下面为你详细介绍使用方法。
✨ 主要特性
- 支持多种音频输入方式，包括本地文件、YouTube 链接和音频链接。
- 借助 MCP 和 librosa 进行音频分析。
📦 安装指南
使用 Smithery 进行自动安装
通过 Smithery 可自动安装 Music Analysis for 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 的节奏起始时间。
📚 详细文档
待办事项
- [x] 添加 URL 到音频文件下载功能
- [x] 添加 YouTube 到音频文件转换
- [ ] 测试多个 Python 环境
- [ ] 改进安装指南
- [ ] 集成 Whisper 进行歌词分析
- [ ] 实现 Docker 解决方案
📄 许可证
文档未提及许可证信息，故跳过此章节。
👨💻 作者
Hugo How - Choong