Axiomworks Youtube MCP

Axiom Works YouTube+YouTube音乐MCP服务器

YouTube和YouTube音乐的权威MCP服务器。 68工具 跨搜索、播放列表、评论、分析、直播和完整的YouTube音乐库管理。

没有其他YouTube MCP服务器涵盖分析、直播、评论（写）、视频上传、， 或 YouTube音乐。这个涵盖了所有这些。

    

快速开始

# Install
pip install axiomworks-youtube-mcp

# Or run directly with uvx (zero install)
uvx axiomworks-youtube-mcp run

添加到克劳德代码

{
  "mcpServers": {
    "youtube": {
      "command": "uvx",
      "args": ["axiomworks-youtube-mcp", "run"]
    }
  }
}

添加到克劳德桌面

{
  "mcpServers": {
    "youtube": {
      "command": "uvx",
      "args": ["axiomworks-youtube-mcp", "run"]
    }
  }
}

设置

服务器在零配置（第0层）下立即工作。添加凭据以解锁更多功能：

axiomworks-youtube-mcp setup

获取API密钥（第1层）

1. 首选 谷歌云控制台
2. 创建项目（或使用现有项目）
3. 启用 YouTube数据API v3
4. 创建API密钥
5. 跑 axiomworks-youtube-mcp setup 并粘贴密钥

设置OAuth（第2层）

YouTube OAuth （点赞、评论、上传、分析）：

1. 在谷歌云控制台中，创建 OAuth 2.0客户端ID （桌面应用程序）
2. 配置OAuth同意屏幕（外部，测试模式，将您的电子邮件添加为测试用户）
3. 下载客户端机密JSON文件
4. 把它放在 ~/.config/axiomworks-youtube-mcp/client_secrets.json
5. 跑 axiomworks-youtube-mcp setup 并遵循OAuth流程

YouTube音乐 （库、历史记录、播放列表）：

由于谷歌内部API的限制，YouTube音乐库访问需要浏览器cookie验证。两种选择：

选项A：交互式设置 （推荐）

1. 跑 axiomworks-youtube-mcp setup 在步骤3中选择“是”
2. 按照提示从Chrome DevTools粘贴请求头

选项B：手动设置

1. 打开https://music.youtube.com登录时在Chrome中
2. 打开DevTools（F12）→ 网络选项卡→ 单击任何请求 music.youtube.com
3. 右键单击请求→ Copy → 复制请求标头
4. 跑 ytmusicapi setup 并在提示时粘贴标题
5. 将输出文件移动到 ~/.config/axiomworks-youtube-mcp/ytmusic-browser.json

注： 浏览器Cookie会定期过期。如果YouTube音乐库调用停止工作，请重新运行设置以刷新Cookie。

工具（共68个）

YouTube搜索和发现（3个工具）

视频操作（8个工具）

渠道运营（6个工具）

播放列表操作（7个工具）

评论（7个工具）

分析（5个工具）

直播（3个工具）

YouTube音乐-搜索和浏览（11个工具）

YouTube音乐库（9个工具）

YouTube音乐-播放列表（6个工具）

YouTube音乐-播客（3个工具）

配额管理

YouTube数据API具有 10000单位/天 配额。此服务器包括内置配额跟踪：

• 80%使用时的警告（8000个单位）
• 100%错误以阻止API调用失败
• 配额每天在太平洋时间午夜重置
• YouTube音乐工具使用单独的内部API 不 受此配额限制

响应缓存

从本地SQLite缓存提供重复查询以减少配额使用：

API缺口

某些YouTube功能无法通过任何官方API获得。看 API_GAPS.md 查看完整的限制列表以及我们对YouTube的改进建议。

关键差距：没有观看历史API，没有YouTube Shorts特定的端点，没有YouTube音乐官方API，没有播放控制。

发展

# Clone
git clone https://github.com/axiomworks-ai/axiomworks-youtube-mcp.git
cd axiomworks-youtube-mcp

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check src/

# Type check
mypy src/

建筑

src/axiomworks_youtube_mcp/
├── server.py          # MCP server + 68 tool definitions
├── config.py          # Configuration and auth tier management
├── cli.py             # CLI: setup, status, run, version
├── clients/
│   ├── youtube.py     # YouTube Data API v3 client
│   ├── ytmusic.py     # YouTube Music client (ytmusicapi)
│   ├── analytics.py   # YouTube Analytics API client
│   └── live.py        # YouTube Live Streaming client
└── utils/
    ├── cache.py       # Response caching (SQLite)
    └── quota.py       # Daily quota tracking and warnings

比较

许可证

Apache许可证2.0 --免费使用、修改和分发。需要署名。

版权所有2026 Axiom Works人工智能

文档

• 用户指南 --用例、创意示例、技巧
• API缺口 -YouTube API限制和上游反馈
• 上游贡献 --ytmusicapi公关目标
• 更新日志 --版本历史

贡献

欢迎投稿！看 贡献.md 作为指导方针。

特别重视帮助的领域：

• 其他YouTube音乐功能通过 ytmusicapi 上游贡献
• 测试覆盖率
• 文件和示例
• 不同MCP客户端的集成指南