使用说明

项目简介

YouTube Music MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它允许 AI 模型通过标准的 MCP 协议来控制 YouTube Music 的播放。该服务器通过调用 YouTube API 和 Chrome 浏览器自动化，实现了音乐搜索和播放的功能，使得 AI 助手可以方便地控制音乐播放。

主要功能点

歌曲搜索: 允许 AI 模型搜索 YouTube Music 上的歌曲，可以根据歌曲名和艺术家名进行搜索。
音乐播放: 允许 AI 模型控制 Chrome 浏览器自动打开 YouTube Music 并播放搜索到的歌曲。

安装步骤

安装 Node.js 和 npm: 确保你的电脑上已经安装了 Node.js 和 npm (Node 包管理器)。

克隆仓库: 使用 git 命令克隆 YouTube Music MCP Server 仓库到本地：

git clone https://github.com/mondweep/youtube-music-mcp-server.git

进入仓库目录: 打开终端或命令提示符，进入克隆下来的仓库目录：
```
cd youtube-music-mcp-server
```
安装依赖: 运行 npm 命令安装项目所需的依赖包：
```
npm install
```
构建项目: 运行 npm 命令构建项目，将 TypeScript 代码编译为 JavaScript 代码：
```
npm run build
```
设置 YouTube API 密钥: 你需要申请 YouTube Data API v3 的密钥，并将其设置为环境变量 'YOUTUBE_API_KEY'。
- 访问 Google Cloud Console 创建或选择一个项目。
- 启用 YouTube Data API v3。
- 创建 API 密钥。
- 将 API 密钥设置为环境变量 'YOUTUBE_API_KEY'。具体设置方法请参考你使用的操作系统环境变量设置方法。

服务器配置

MCP 服务器需要配置到 MCP 客户端中才能使用。以下是配置 YouTube Music MCP Server 的 JSON 格式配置信息，你需要将其添加到你的 MCP 客户端配置文件中。以 Claude Desktop 为例，配置文件的路径通常为：

macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

将以下 JSON 配置添加到 'mcpServers' 字段下：

{
  "mcpServers": {
    "youtube-music-server": {
      "command": "/path/to/youtube-music-server/build/index.js" // 请将 "/path/to/youtube-music-server" 替换为 youtube-music-server 项目在你的电脑上的实际路径
    }
  }
}

注意: 'command' 字段的值必须是 'youtube-music-server' 项目 'build' 目录下 'index.js' 文件的绝对路径。你需要根据你的实际项目存放路径进行修改。

基本使用方法

配置完成后，启动你的 MCP 客户端 (如 Claude Desktop)。当 AI 模型需要播放 YouTube Music 时，它会通过 MCP 协议调用 'play_song' 工具。你可以通过自然语言指令指示 AI 助手播放歌曲，例如：

"播放歌曲 [歌曲名]，艺术家是 [艺术家名]"

AI 助手会将你的指令转换为对 'play_song' 工具的调用，YouTube Music MCP Server 接收到请求后，会自动搜索并在 Chrome 浏览器中播放你指定的歌曲。

关键词