Youtubemusic MCP

MCPAI代理

提供方 codeRisshi25

AI代理 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个生产级的模型上下文协议(MCP)服务器,连接YouTube Music和Claude等AI助手,实现完整的MCP原语集(工具、资源和提示),提供真正的代理音乐体验。

一句话选型结论

按资料字段整理

Youtubemusic MCP 属于AI代理类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 15 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量15暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

音乐服务Python本地部署AI集成服务器模型上下文协议YouTubeMusic

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
python3 -m venv venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 15 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 15 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Youtubemusic MCP当前 15 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方codeRisshi25上游标注的维护方 codeRisshi25
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.4 KB
来自项目仓库与上游目录的原文,未做删改

YouTube音乐MCP服务器

一个生产级的模型上下文协议(MCP)服务器,将YouTube音乐连接到克劳德等人工智能助手。\
实现完整的MCP基元集-- 工具、资源和提示 --真正的主体音乐体验。


建筑```

┌────────────────────────────────────────────────────────────┐
│ Claude / AI Assistant │
└──────────────────────┬─────────────────────────────────────┘
│ Model Context Protocol (stdio)
┌──────────────────────▼─────────────────────────────────────┐
│ YouTube Music MCP Server v2 │
│ │
│ ┌─────────────┐ ┌───────────────┐ ┌──────────────────┐ │
│ │ 15 Tools │ │ 3 Resources │ │ 3 Prompts │ │
│ │ │ │ │ │ │ │
│ │ search │ │library:// │ │weekly-discovery │ │
│ │ stats │ │ songs │ │mood-based- │ │
│ │ similar ★ │ │ artists │ │ playlist │ │
│ │ recommend ★ │ │ playlists │ │artist-deep-dive │ │
│ │ smart pl ★ │ └───────────────┘ └──────────────────┘ │
│ │ charts │ │
│ │ insights │ ┌───────────────────────────────────┐ │
│ │ moods │ │ TTL Cache (5 min) • Async ★ │ │
│ │ ... │ │ Custom Exceptions • Logging │ │
│ └─────────────┘ └───────────────────────────────────┘ │
└──────────────────────┬─────────────────────────────────────┘
│ ytmusicapi
┌──────────────────────▼─────────────────────────────────────┐
│ YouTube Music API │
└────────────────────────────────────────────────────────────┘
★ = Agentic / async feature


______________________________________________________________________

## 特性

**15个工具·3个资源·3个提示——完整的MCP原语覆盖:**

### 🛠️ 工具

|工具|说明|
| ---------------------------- | --------------------------------------------------------------- |
| `get_liked_songs_count` |歌曲总数(绕过YT显示限制)|
| `get_library_stats` |歌曲、艺术家、播放列表+详细分类|
| `search_music` |使用类型过滤器搜索(歌曲/专辑/艺术家/播放列表/视频)|
| `get_top_artists` |用视觉进度条对艺术家进行排名|
| `find_similar_songs` ⭐      | **真实** YTMusic广播引擎——不是虚假的艺术家搜索|
| `get_recommendations` ⭐     | 前5位艺术家的异步并行获取|
| `create_playlist_from_songs` |根据搜索查询创建和填充播放列表|
| `list_playlists` |所有带有ID和歌曲计数的播放列表|
| `get_playlist_songs` |浏览任何播放列表中的歌曲|
| `add_songs_to_playlist` |将歌曲添加到现有播放列表|
| `build_smart_playlist` ⭐    | **能动性** 6步流程:情绪→类别→曲目→过滤器→保存|
| `explore_moods` |发现所有YTMusic情绪和流派类别|
| `get_charts` |全球或特定国家的趋势图|
| `get_listening_insights` |历史分析:模式、多样性得分、见解|
| `get_server_info` |身份验证方法、缓存状态、版本、功能|

### 📦 资源(Claude被动可读)

|资源URI|描述|
| --------------------- | -------------------------------- |
| `library://songs` |结构化JSON格式的完整库|
| `library://artists` |艺术家百分比排名|
| `library://playlists` |所有播放列表均为结构化JSON|

### 💬 提示(引导对话开始者)

|提示|描述|
| ---------------------- | ---------------------------------------- |
| `weekly-discovery-mix` |指导每周音乐发现工作流程|
| `mood-based-playlist` |协作情绪→ 播放列表会话|
| `artist-deep-dive` |完整的艺术家探索+聆听计划|

______________________________________________________________________

## 安装

### 先决条件

- Python 3.10或更高版本
- YouTube音乐帐户
- 浏览器开发工具访问(用于身份验证)

### 设置

1. **克隆存储库**```bash
git clone https://github.com/codeRisshi25/youtubemusic-mcp.git
cd youtubemusic-mcp
  1. 创建虚拟环境```bash
    python3 -m venv venv
    source venv/bin/activate # Linux/macOS

OR

venv\Scripts\activate # Windows


3. **安装依赖项**```bash
pip install -e .

认证

选择一种身份验证方法:

选项A:Cookie文件(最简单——推荐)

  1. 访问 music.youtube.com 并登录
  2. 打开开发人员工具(F12)
  3. 首选 网络 选项卡并刷新页面
  4. 点击任何请求→ 标头 → 复制完整 cookie: 价值
  5. 将其粘贴到名为的文件中 cookie.txt 在项目目录中
  6. 完成! 服务器自动生成 browser.json 首次启动时```bash

Optional: validate cookies before starting the server

python update_auth.py


**注:** Cookie通常持续6-24个月。当它们过期时,只需将新鲜的饼干粘贴到 `cookie.txt` 并重新启动。

### 选项B:OAuth(长期)

看 docs/OAUTH_SETUP.md 获取完整的OAuth设置说明。

______________________________________________________________________

## 用法

### 使用MCP检查员进行测试```bash
npx @modelcontextprotocol/inspector venv/bin/python server.py

打开web界面 http://localhost:6274 测试所有15个工具、3个资源和3个提示。

Claude桌面集成

  1. 配置文件位置:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
  1. 添加配置:```json
    {
    "mcpServers": {
    "youtube-music": {
    "command": "/path/to/venv/bin/python",
    "args": ["/path/to/server.py"]
    }
    }
    }

3. **重新启动克劳德桌面**

看 docs/CLAUDE_SETUP.md 详细说明。

______________________________________________________________________

## 可用工具

看 功能部分 上面是所有15种工具的完整表格。

### 机构亮点

**`build_smart_playlist`** --核心代理工具。在单个工具调用中运行一个6步流水线:```
Step 1: Fetch all Moods & Genres from YouTube Music
Step 2: Match your mood keyword to a real category
Step 3: Pull mood playlist pool from that category
Step 4: Sample tracks across multiple playlists
Step 5: Apply energy-level filter (high/medium/low)
Step 6: Optionally create & save to YouTube Music

find_similar_songs --用途 get_watch_playlist(radio=True),真正的YTMusic相似性引擎,而不是虚假的艺术家搜索。

get_recommendations --从5位艺术家那里获取 asyncio.gather() 真正的并行执行。


运行测试```bash

pip install -e ".[dev]"
pytest tests/ -v
```

51个测试,涵盖身份验证、缓存、所有工具、资源、提示和路由——不需要网络(完全模拟)。


故障排除

身份验证错误

如果您在大约6个月后出现身份验证错误:

  1. 您的Cookie可能已过期
  2. 按照中的简单更新过程进行操作 docs/AUTH_UPDATE.md
  3. 您只需从浏览器中粘贴新的Cookie

在Claude中未检测到服务器

  • 在中使用绝对路径 claude_desktop_config.json
  • 配置更改后重新启动Claude Desktop
  • 检查克劳德的日志→ Help → 查看日志

导入错误

  • 确保虚拟环境已激活
  • 跑 pip install -e . 在项目目录中

启动时服务器崩溃

  • 验证 browser.json 或 oauth.json 存在
  • 检查文件权限
  • 看 docs/CLAUDE_SETUP.md 详细故障排除

贡献

看 docs/CONTRIBUTING.md 关于贡献指南。


许可证

MIT许可证-请参阅 许可证

版权所有(c)2025里希·拉吉·森


链接

  • GitHub 问题
  • 讨论

建于 ytmusicapi • 主控程序

⭐ 星如果有用!

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Youtubemusic MCP 怎么安装?

在客户端按下面的安装命令接入:python3 -m venv venv。装完在客户端配置里引用同一个包或端点。

Youtubemusic MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Youtubemusic MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Youtubemusic MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Youtubemusic MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Youtubemusic MCP 能提供哪些能力?

资料显示约 15 个工具;能力标签包括 Python、Claude、Claude Desktop。具体工具清单以官方文档为准。

Youtubemusic MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Youtubemusic MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。