MCP Music Analysis

🚀 MCP 音楽分析

このリポジトリには、モデルコンテキストプロバイダ（MCP） が含まれています。このプロバイダは、MCP と librosa を使用してオーディオを分析し、ローカルファイル、YouTube リンク、またはオーディオリンクをサポートしています。

🚀 クイックスタート

このリポジトリには、オーディオ分析に特化した モデルコンテキストプロバイダ（MCP） が含まれています。MCP と librosa を利用して、ローカルファイルや YouTube リンク、オーディオリンクなど様々なソースの音楽データを分析することができます。

✨ 主な機能

• ローカルファイル、YouTube リンク、オーディオリンクに対応した音楽分析機能。
• Claude Desktop との連携が可能。

📦 インストール

Smithery を使用した自動インストール

Smithery を通じて、Claude Desktop 用の Music Analysis を自動インストールできます。

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 の持続時間を教えてください。
このファイル /path/to/another_audio.mp3 の MFCC を計算してください。
music.wav ファイルのスペクトル重心値は何ですか？
https://www.youtube.com/watch?v=8HFiFd9vx1c のリズムの開始時間を知りたいです。

📄 今後の予定

• [x] URL からのオーディオファイルダウンロード機能の追加
• [x] YouTube からのオーディオファイル変換機能の追加
• [ ] 複数の Python 環境でのテスト
• [ ] インストールガイドの改善
• [ ] Whisper を用いた歌詞分析の統合
• [ ] Docker ソリューションの実装

📄 作者

Hugo How-Choong