AI导哈

音频播放控制服务

一个允许Claude控制电脑音频播放的模型上下文协议（MCP）服务器，支持播放MP3、WAV和OGG音频文件，并具有安全文件访问功能。

  • by Here-and-Tomorrow-LLC
  • Python
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 Here-and-Tomorrow-LLC/audio-player-mcp

使用说明

音频播放器MCP服务器

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

特性

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

需求

安装

  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. 打开克劳德桌面设置并导航到：
    Developer > Edit Config

  2. 找到您的配置文件：

    • 苹果电脑: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 视窗: %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来控制音频播放：

  • “我有什么音频文件？”
  • “播放歌曲.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

  2. 导航到存储库目录：

    cd audio-player-mcp

  3. 安装开发依赖项：

    pip install -e ".[dev]"

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

    mcp dev src/audio_player_mcp/player.py

许可证

该项目根据 MIT许可证.

相关 MCP