JinDaGe - mcp-music-analysis MCP Details

article

README

🚀 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

mcp-music-analysis