YouTube音乐MCP服务器
一个模型上下文协议(MCP)服务器,使AI助手能够与YouTube音乐进行交互。通过自然语言创建播放列表、搜索歌曲和管理音乐库。
特性
- 🎵 创建播放列表:使用自定义标题和描述创建新的播放列表
- 🔍 搜索歌曲:按名称、艺术家或专辑查找歌曲
- ➕ 添加歌曲:将歌曲添加到现有播放列表
- 📋 列表播放列表:查看您的所有播放列表
- 👁️ 查看播放列表详细信息:从特定播放列表中获取歌曲和信息
- 🗑️ 删除播放列表:删除不再需要的播放列表
安装
-
克隆或下载此存储库
-
安装依赖项:```bash
pip install -r requirements.txt
3. **设置身份验证**
⚠️ **重要**:由于YouTube服务器端的更改,OAuth身份验证当前已中断(第676期). **改用浏览器身份验证** (请参阅下面的快速设置)。
### 快速设置(浏览器身份验证-推荐)
运行浏览器身份验证设置:```bash
python setup_browser_auth.py
按照提示从浏览器中提取请求标头。
有关截图的详细说明,请参阅 ytmusicapi浏览器认证官方文档.
替代方案:OAuth安装程序(当前不工作)
- 创建Google OAuth凭据 (一次性设置-当前已损坏):
a.转到 谷歌云控制台
b.创建新项目或选择现有项目
c.启用 YouTube数据API v3:
- 转到“API和服务”→ “启用API和服务”
- 搜索“YouTube数据API v3”并启用它
d.创建OAuth凭据:
- 转到“API和服务”→ “凭据”
- 点击“创建凭据”→ “OAuth客户端ID”
- 重要:选择应用程序类型: “电视和有限输入设备”
- ⚠️ 不要选择“桌面应用程序”或“Web应用程序”-它们不起作用!
- 为其命名(例如,“YouTube音乐MCP”)
- 点击“创建”
- 复制您的 客户端ID 和 客户端密钥
- 设置OAuth身份验证:```bash
python setup_auth.py
脚本将:
- 询问您的客户ID和客户密码
- 打开Google OAuth浏览器
- 请求您授予YouTube音乐权限
- 将您的凭据安全地保存到 `~/.config/ytmusic/oauth.json`
就是这样!身份验证已保存,并将自动使用。
**备注**:您可以为多个ytmusicapi应用程序重用相同的OAuth凭据。
## 用法
### 使用克劳德桌面
将此添加到您的Claude Desktop配置文件中:
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**视窗**: `%APPDATA%\Claude\claude_desktop_config.json````json
{
"mcpServers": {
"youtube-music": {
"command": "python",
"args": ["/absolute/path/to/youtube-music/server.py"]
}
}
}
替换 /absolute/path/to/youtube-music/ 此目录的实际路径。
与其他MCP客户端
此服务器使用stdio传输,可以与任何兼容MCP的客户端一起使用。将其配置为运行:```bash
python /path/to/server.py
## 可用工具
### `create_playlist`
在YouTube音乐库中创建新的播放列表。
**参数**:
- `title` (必填):播放列表名称
- `description` (可选):播放列表描述
- `privacy_status` (可选):“公共”、“私人”或“未列出”(默认值:“私人”)
**示例**:“创建一个名为‘健身组合’的播放列表,将隐私设置为私人”
### `search_songs`
在YouTube音乐上搜索歌曲。
**参数**:
- `query` (必填):搜索词(歌曲、艺术家、专辑)
- `limit` (可选):要返回的最大结果(默认值:10)
**示例**:“搜索泰勒·斯威夫特的歌曲”
### `add_songs_to_playlist`
将歌曲添加到现有播放列表中。
**参数**:
- `playlist_id` (必填):播放列表ID
- `video_ids` (必填):要添加的YouTube视频ID数组
**示例**:“将这些歌曲添加到我的锻炼播放列表中”
### `get_playlists`
列出库中的所有播放列表。
**示例**:“显示我的播放列表”
### `get_playlist`
从特定播放列表中获取详细信息和歌曲。
**参数**:
- `playlist_id` (必填):播放列表ID
- `limit` (可选):要返回的最大歌曲数(默认值:100)
**示例**:“显示我的‘Chill Vibes’播放列表中的内容”
### `delete_playlist`
从库中删除播放列表。
**参数**:
- `playlist_id` (必填):要删除的播放列表ID
**示例**:“删除我的‘Old Mix’播放列表”
## 对话示例
一旦连接到像Claude Desktop这样的MCP客户端:
> **你**:“创建一个名为‘Road Trip 2024’的新播放列表”
>
> **克劳德**: *创建播放列表并返回播放列表ID*
> **你**:“搜索傻朋克的歌曲”
>
> **克劳德**: *返回带有视频ID的歌曲列表*
> **你**:“将前三首歌曲添加到我的Road Trip 2024播放列表中”
>
> **克劳德**: *将歌曲添加到播放列表*
## 安全
- 您的OAuth凭据存储在本地 `~/.config/ytmusic/oauth.json`
- 除了谷歌的YouTube音乐API外,凭据不会在任何地方共享或传输
- 您可以随时从您的 Google帐户权限页面
## 故障排除
### OAuth中的“400个错误请求”
**这是一个已知的问题!** 由于YouTube服务器端的更改,OAuth身份验证被破坏。切换到浏览器身份验证:```bash
python setup_browser_auth.py
看 GitHub第676期 了解详情。
“未找到OAuth凭据”或“未找到身份验证凭据”
运行安装脚本:
- 浏览器身份验证(推荐):
python setup_browser_auth.py - OAuth(当前已损坏):
python setup_auth.py
“身份验证失败”或“客户端无效”(仅限OAuth)
- 确保您在Google Cloud Console中创建了OAuth凭据
- 验证您是否选择了“电视和有限输入设备”作为应用程序类型
- 确保在您的Google Cloud项目中启用YouTube Data API v3
- 仔细检查您的客户端ID和客户端密码是否正确
- 尝试删除
~/.config/ytmusic/oauth.json并再次运行安装程序 - 确保在OAuth流程中授予所有请求的权限
- 注: 即使配置正确,由于YouTube的更改,OAuth也可能无法工作
“服务器未连接”
- 验证MCP客户端配置中的路径是否正确
- 确保安装了Python和依赖项
- 检查server.py文件是否具有执行权限
- 确保已设置身份验证:检查
~/.config/ytmusic/oauth.json存在
需要更多帮助?
查看ytmusicapi官方文档:
- 浏览器身份验证设置 (推荐)
- OAuth身份验证设置 (目前已损坏)
- 使用指南
需求
- Python 3.10或更高版本
- YouTube音乐帐户
- Internet连接
贡献
欢迎投稿!请阅读我们的 贡献指南 有关以下内容的详细信息:
- 如何设置开发环境
- 代码风格指南
- 如何提交pull请求
- 报告错误和请求功能
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
鸣谢
内置:
- ytmusicapi -非官方YouTube音乐API
- MCP Python SDK -模型上下文协议
支持
- 🐛 发现bug了吗? 打开一个问题
- 💡 有功能请求吗? 打开一个问题
- 📖 需要帮助? 检查 故障排除 部分或展开讨论
