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

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

特徴

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

要件

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