Audio Player

🚀 音频播放器 MCP 服务器

这是一个模型上下文协议（MCP）服务器，允许 Claude 控制您计算机上的音频播放，带来便捷的音频操作体验。

✨ 主要特性

• 支持播放 MP3、WAV 和 OGG 格式的音频文件，满足多样化的音频需求。
• 可列出音乐目录中的可用音频文件，方便查找想听的音乐。
• 能够停止音频播放，操作简单直接。
• 通过目录隔离实现文件访问的安全性，保障音频文件的隐私和安全。

📦 安装指南

克隆仓库

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

进入仓库目录

cd audio-player-mcp

以可编辑模式安装包

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 下许可。