Audio Player

🚀 音頻播放器 MCP 服務器

這是一個允許 Claude 控制您計算機上音頻播放的模型上下文協議（MCP）服務器。它能讓您通過 Claude 便捷地管理音頻播放，為音頻操作帶來新體驗。

🚀 快速開始

現在您可以讓 Claude 控制音頻播放：

• “我有哪些音頻文件？”
• “播放 song.mp3。”
• “停止音樂。”

✨ 主要特性

• 支持播放 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 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 的日誌：

• 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 下許可。