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

Claude がコンピューター上のオーディオ再生を制御できるようにする Model Context Protocol (MCP) サーバー。

特徴

• MP3、WAV、OGG オーディオ ファイルを再生します。

• 音楽ディレクトリ内の利用可能なオーディオ ファイルを一覧表示します。

• オーディオの再生を停止します。

• ディレクトリ分離による安全なファイル アクセス。

Related MCP server: Spotify MCP Server

要件

• Python 3.10 以上。

• Claude Desktop （最新バージョン）。

インストール

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 デスクトップの設定を開き、次の場所に移動します。
   Developer > Edit Config

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"
         }
       }
     }
   }

   ウィンドウズ:

   {
     "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 のログを確認してください。

• マック：

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

• ウィンドウズ:

  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 ライセンスに基づいてライセンスされています。