内容
# YouTube MCP 服务器设置指南
一个Python MCP服务器，允许Claude在YouTube上搜索艺术家并管理您的账户中的播放列表。
---
## 前置条件
- Python 3.11 或更新版本
- 具有YouTube的谷歌账户
---
## 步骤 1 — 获取谷歌API凭证
1. 访问 [console.cloud.google.com](https://console.cloud.google.com)
2. 创建一个新项目（或选择一个现有的项目）
3. 导航到 **APIs & Services → Library**
4. 搜索 **YouTube Data API v3** 并点击 **启用**
5. 访问 **APIs & Services → Credentials**
6. 点击 **+ 创建凭证 → OAuth 客户端 ID**
7. 应用程序类型：**桌面应用程序** → 给它一个名称 → 点击 **创建**
8. 点击 **下载 JSON** — 将文件保存为 `client_secret.json` 在此文件夹中
---
## 步骤 2 — 安装依赖项
在此文件夹中打开终端并运行：
```bash
pip install -r requirements.txt
```
---
## 步骤 3 — 配置Claude Desktop
打开您的Claude Desktop配置文件：
**Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
在 `"mcpServers"` 对象中添加以下条目（如果对象不存在，请创建它）：
```json
{
"mcpServers": {
"youtube-playlist-manager": {
"command": "python",
"args": ["/FULL/PATH/TO/THIS/FOLDER/server.py"]
}
}
}
```
将 `/FULL/PATH/TO/THIS/FOLDER/` 替换为实际保存这些文件的文件夹路径。
**Mac 示例：**
```json
{
"mcpServers": {
"youtube-playlist-manager": {
"command": "python3",
"args": ["/Users/yourname/youtube_mcp/server.py"]
}
}
}
```
---
## 步骤 4 — 首次运行（OAuth 流）
1. **重启Claude Desktop** 保存配置后
2. 首次使用YouTube工具时，将打开一个浏览器窗口，要求您登录Google并授予访问权限
3. 批准后，将在本地保存一个 `token.json` 文件 — 您无需再次登录
---
## 可用工具
| 工具 | 描述 |
|------|-------------|
| `search_artists` | 按名称搜索艺术家/音乐家频道 + 可选的流派 |
| `search_videos` | 搜索音乐视频，可选地在特定频道内 |
| `create_playlist` | 在您的YouTube账户上创建一个新播放列表 |
| `add_videos_to_playlist` | 将视频（按ID）添加到现有播放列表 |
| `list_my_playlists` | 列出您的所有YouTube播放列表 |
---
## 在Claude中尝试的示例提示
- *"在YouTube上搜索爵士吉他艺术家并创建一个包含他们最佳视频的播放列表"*
- *"查找低保真嘻哈频道并创建一个名为'专注音乐'的私人播放列表"*
- *"搜索艺术家'Khruangbin'的视频并将它们添加到我的现有播放列表中"*
- *"列出我所有的YouTube播放列表"*
---
## 此文件夹中的文件
```
youtube_mcp/
├── server.py ← MCP 服务器（主文件）
├── requirements.txt ← Python 依赖项
├── client_secret.json ← 您添加此文件（从Google Cloud下载）
├── token.json ← 首次登录后自动创建
└── README.md ← 本文件
```
---
## 故障排除
**"client_secret.json 未找到"** → 确保您已正确下载和重命名文件，并将其放在与 `server.py` 相同的文件夹中。
**浏览器中“访问被阻止”** → 您的OAuth应用程序可能处于“测试”模式。前往Google Cloud Console → OAuth 同意屏幕 → 将您的Google账户添加为测试用户。
**工具未在Claude中显示** → 仔细检查 `claude_desktop_config.json` 中的路径，并完全重启Claude Desktop。
