音频播放器 MCP 服务器

这是一个允许 Claude 控制您计算机上音频播放的模型上下文协议（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 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 控制音频播放：

• “我有哪些音频文件？”
• “播放 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 License 下许可。