音频播放器 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" } } } }
   视窗：
   { "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 许可。