Audio Player

🚀 オーディオプレイヤー MCP サーバー

このサーバーは、Claude がコンピュータ上のオーディオ再生を制御できるようにするモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

• MP3、WAV、OGG 形式のオーディオファイルを再生します。
• 音楽ディレクトリ内の利用可能なオーディオファイルを一覧表示します。
• オーディオ再生を停止します。
• ディレクトリの分離により、ファイルアクセスの安全性を実現します。

📦 インストール

1. リポジトリをクローンします：

   git clone https://github.com/Here-and-Tomorrow-LLC/audio-player-mcp.git
   

2. リポジトリディレクトリに移動します：

   cd audio-player-mcp
   

3. パッケージを編集可能なモードでインストールします：

   pip install -e .
   

📚 ドキュメント

Claude Desktop との設定

1. Claude Desktop の設定を開き、以下のパスに移動します：
   開発者 > 設定の編集

2. オペレーティングシステムに応じて設定ファイルを見つけます：

   • Mac：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

3. 以下の設定を追加し、オペレーティングシステムに合わせて調整します：

   Mac/Linux:

   {
     "mcpServers": {
       "audio-player": {
         "command": "/path/to/your/venv/bin/python",
         "args": [
           "/path/to/your/audio-player-mcp/src/audio_player_mcp/player.py"
         ],
         "env": {
           "AUDIO_PLAYER_DIR": "/path/to/your/audio/files"
         }
       }
     }
   }
   

   Windows:

   {
     "mcpServers": {
       "audio-player": {
         "command": "C:\path\to\your\venv\Scripts\python.exe",
         "args": [
           "C:\path\to\your\audio-player-mcp\src\audio_player_mcp\player.py"
         ],
         "env": {
           "AUDIO_PLAYER_DIR": "C:\path\to\your\audio\files"
         }
       }
     }
   }
   

   注意：AUDIO_PLAYER_DIR を設定しない場合、サーバーはホームディレクトリ内の Music フォルダをデフォルトで使用します。

4. Claude Desktop を再起動します。

使用方法

Claude でオーディオ再生を制御できます：

• “私の持っているオーディオファイルは何ですか？”
• “song.mp3 を再生して。”
• “音楽を停止して。”

トラブルシューティング

問題が発生した場合は、Claude のログを確認してください：

• Mac:

  tail -f ~/Library/Logs/Claude/mcp*.log
  

• Windows:

  type "%APPDATA%\Claude\logs\mcp*.log"
  

開発

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/audio-player-mcp.git
   

2. リポジトリディレクトリに移動します：

   cd audio-player-mcp
   

3. 開発用の依存関係をインストールします：

   pip install -e ".[dev]"
   

4. 開発モードで MCP サーバーを実行します：

   mcp dev src/audio_player_mcp/player.py
   

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。