音频播放器 MCP 服务器

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

功能

• 播放 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 设置并导航到： 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"
         }
       }
     }
   }
   

   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 许可证 获得许可。