🚀 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

仓库徽章