AI导哈

YouTube音乐交互服务器

一个用于搜索、播放和获取YouTube音乐信息的服务器工具，支持歌曲、艺术家、专辑和播放列表的搜索，并提供详细的歌曲信息和浏览器直接播放功能。

  • by vweiss960
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 vweiss960/youtube_music_mcp_server

使用说明

youtube_music_mcp-server

用于与YouTube音乐交互的MCP服务器。此服务器提供搜索、播放和获取YouTube音乐上歌曲信息的工具。

特性

  • 在YouTube音乐中搜索歌曲、艺术家、专辑和播放列表
  • 获取详细的歌曲信息
  • 直接在浏览器中播放歌曲
  • 使用Brave search API进行网络搜索
  • 获取当前日期和时间

安装说明

先决条件

  • Python 3.8或更高版本
  • Git

安装

  1. 克隆存储库：

    git clone https://github.com/yourusername/youtube_music_mcp_server.git
cd youtube_music_mcp_server

  2. 创建虚拟环境：

    窗户：

    python -m venv venv
venv\Scripts\activate

    macOS/Linux：

    python -m venv venv
source venv/bin/activate

  3. 安装依赖项：

    pip install -r requirements.txt

  4. （可选）设置环境变量：

    如果您想使用Brave Search API，请创建 .env 根目录中的文件：

    BRAVE_API_KEY=your_api_key_here

运行MCP服务器

您可以通过两种方式运行服务器：

选项1：直接执行

python main.py

选项2：使用Claude Desktop进行配置

  1. 打开您的Claude Desktop配置文件：

    • 窗户： %APPDATA%\Claude\claude_desktop_config.json
    • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
    • Linux： ~/.config/Claude/claude_desktop_config.json

  2. 添加以下配置（根据需要调整路径）：

    窗户：

    {
  "mcpServers": {
    "youtube-music": {
      "command": "C:\\path\\to\\youtube_music_mcp_server\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\youtube_music_mcp_server\\main.py"]
    }
  }
}

    macOS/Linux：

    {
  "mcpServers": {
    "youtube-music": {
      "command": "/path/to/youtube_music_mcp_server/venv/bin/python",
      "args": ["/path/to/youtube_music_mcp_server/main.py"]
    }
  }
}

  3. 重新启动Claude Desktop以加载MCP服务器。

可用工具

  • searchyoutube_music -搜索歌曲、艺术家、专辑或播放列表
  • get_song_details -获取特定歌曲的信息
  • play_in_browser -在默认浏览器中打开YouTube音乐中的歌曲
  • 勇敢的网络搜索 -执行网络搜索（需要BRAVE_API_KEY）
  • get_current _日期 -获取当前日期和时间

故障排除

  • 模块未找到错误： 确保您已激活虚拟环境并安装了依赖项 pip install -r requirements.txt
  • YouTube音乐API错误： ytmusicapi可能需要身份验证。检查 ytmusicapi文档 了解更多详情。
  • Brave Search不起作用： 确保您的 BRAVE_API_KEY 在中设置正确 .env 文件。

相关 MCP