音频播放器 MCP 服务器

模型上下文协议 (MCP) 服务器允许 Claude 控制计算机上的音频播放。

特征

• 播放 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 Desktop 设置并导航至：
   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 来控制音频播放：

• “我有哪些音频文件？”

• “播放歌曲.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 许可。