金大哥 - Audio Player MCP 详情

article

README

🚀 音频播放器 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 配置

打开 Claude Desktop 设置并导航至：开发者 > 编辑配置。
根据您的操作系统找到配置文件：
- Mac：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json
添加以下配置，根据您的操作系统进行调整：
- 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"

开发

克隆仓库：

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

cd audio-player-mcp

安装开发依赖项：

pip install -e ".[dev]"

以开发模式运行 MCP 服务器：

mcp dev src/audio_player_mcp/player.py

📄 许可证

该项目在 MIT License 下许可。

Audio Player