Audio Player MCP Server

音频播放器MCP服务器

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

特性

• 播放MP3、WAV和OGG音频文件。
• 列出音乐目录中的可用音频文件。
• 停止音频播放。
• 使用目录隔离保护文件访问。

需求

• Python 3.10或更高版本。
• 克劳德桌面 （最新版本）。

安装

1. 克隆存储库：

   git clone https://github.com/Here-and-Tomorrow-LLC/audio-player-mcp.git

1. 导航到存储库目录：

   cd audio-player-mcp

1. 在可编辑模式下安装软件包：

   pip install -e .

使用Claude Desktop进行设置

1. 打开克劳德桌面设置并导航到：\

Developer > Edit Config

1. 找到您的配置文件：

- 苹果电脑: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json

1. 根据您的操作系统添加以下配置：

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 主目录中的文件夹。

1. 重新启动克劳德桌面。

用法

现在，您可以通过询问Claude来控制音频播放：

• “我有什么音频文件？”
• “播放歌曲.mp3。”
• “停止音乐。”

故障排除

如果有什么不起作用，请查看克劳德的日志：

• 雨衣：

  tail -f ~/Library/Logs/Claude/mcp*.log

• 窗户：

  type "%APPDATA%\Claude\logs\mcp*.log"

发展

1. 克隆存储库：

   git clone https://github.com/yourusername/audio-player-mcp.git

1. 导航到存储库目录：

   cd audio-player-mcp

1. 安装开发依赖项：

   pip install -e ".[dev]"

1. 在开发模式下运行MCP服务器：

   mcp dev src/audio_player_mcp/player.py

许可证

该项目根据 MIT许可证.