关键词

音频播放控制本地音乐语音助手Claude 扩展个人应用

项目简介

Audio Player MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在让 Claude 等大型语言模型（LLM）能够控制您计算机上的音频播放。通过这个服务器，您可以让 Claude 播放本地音乐文件，实现语音控制音乐播放的功能。

主要功能点

  • 音频播放控制: 支持播放、停止本地音频文件。
  • 文件列表: 能够列出指定音乐目录下的音频文件，方便 Claude 了解可播放的内容。
  • 安全的文件访问: 通过目录隔离限制文件访问范围，确保只访问预设音乐目录下的文件。
  • 支持多种音频格式: 兼容常见的 MP3、WAV 和 OGG 音频格式。

安装步骤

  1. 克隆仓库: 首先，将仓库代码克隆到您的本地计算机。

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

  2. 进入仓库目录: 使用命令行工具进入克隆下来的 'audio-player-mcp' 目录。

    cd audio-player-mcp

  3. 安装软件包: 使用 pip 安装项目，建议使用 editable mode (-e) 安装，方便开发修改。

    pip install -e .

服务器配置

要将 Audio Player MCP Server 与 Claude Desktop 配合使用，您需要编辑 Claude Desktop 的配置文件，添加 MCP 服务器的配置信息。

  1. 打开 Claude Desktop 配置: 在 Claude Desktop 设置中，找到 'Developer > Edit Config' 选项。

  2. 定位配置文件: 根据您的操作系统，找到 'claude_desktop_config.json' 配置文件：

    • Mac: '~/Library/Application Support/Claude/claude_desktop_config.json'
    • Windows: '%APPDATA%\Claude\claude_desktop_config.json'

  3. 添加服务器配置: 在 'claude_desktop_config.json' 文件中，找到 'mcpServers' 部分（如果没有则创建），并添加以下 JSON 配置。请根据您的操作系统选择相应的配置，并务必替换路径为您的实际路径。

    Mac/Linux 配置示例:

    {
  "mcpServers": {
    "audio-player": {
      "command": "/path/to/your/venv/bin/python",  // Python 解释器路径，如果您使用虚拟环境，请指向虚拟环境中的 Python
      "args": [
        "/path/to/your/audio-player-mcp/src/audio_player_mcp/player.py" // player.py 脚本的路径
      ],
      "env": {
        "AUDIO_PLAYER_DIR": "/path/to/your/audio/files"  // 可选：您的音乐文件存放目录，不设置则默认为用户 Music 目录
      }
    }
  }
}

    Windows 配置示例:

    {
  "mcpServers": {
    "audio-player": {
      "command": "C:\path\to\your\venv\Scripts\python.exe", // Python 解释器路径，如果您使用虚拟环境，请指向虚拟环境中的 python.exe
      "args": [
        "C:\path\to\your\audio-player-mcp\src\audio_player_mcp\player.py" // player.py 脚本的路径
      ],
      "env": {
        "AUDIO_PLAYER_DIR": "C:\path\to\your\audio\files"  // 可选：您的音乐文件存放目录，不设置则默认为用户 Music 目录
      }
    }
  }
}

    注意:

    • 'command' 指向您系统中 Python 解释器的可执行文件路径。如果您使用了虚拟环境，请确保指向虚拟环境中的 Python 解释器。
    • 'args' 是一个列表，包含启动 'player.py' 脚本所需的参数。这里只需要指定 'player.py' 脚本的完整路径。
    • 'env' 是一个可选的环境变量配置。'AUDIO_PLAYER_DIR' 用于指定音乐文件存放的目录。如果您不设置此环境变量，服务器将默认使用用户目录下的 "Music" 文件夹。

  4. 重启 Claude Desktop: 完成配置后，重启 Claude Desktop 使配置生效。

基本使用方法

配置完成后，您就可以通过 Claude 与 Audio Player MCP Server 交互，控制音频播放了。您可以尝试以下指令与 Claude 对话：

  • 询问 Claude 有哪些音频文件： "What audio files do I have?" 或 “你有哪些音乐？”
  • 让 Claude 播放音乐： "Play song.mp3." (将 "song.mp3" 替换为您音乐目录下的文件名) 或 “播放 song.mp3”
  • 让 Claude 停止播放： "Stop the music." 或 “停止播放”

Claude 应该能够理解这些指令，并调用 Audio Player MCP Server 执行相应的操作。您可以通过查看 Claude 的日志文件来排查问题（日志文件路径在 README.md 的 Troubleshooting 部分有说明）。

信息

分类

桌面与硬件

访问项目