AI导哈

YouTube视频管理协议服务器

用于YouTube API集成的模型上下文协议服务器，支持搜索视频、管理播放列表并通过Claude Desktop或其他MCP客户端直接与YouTube交互。

  • by aardeshir
  • JavaScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 aardeshir/youtube-mcp

使用说明

YouTube MCP服务器

用于YouTube API集成的模型上下文协议（MCP）服务器。搜索视频、管理播放列表，并直接通过Claude Desktop或其他MCP客户端与YouTube互动。

特性

  • 🔍 搜索YouTube视频
  • 📋 创建和管理播放列表
  • ➕ 将视频添加到播放列表
  • 📝 列出用户播放列表
  • 🗑️ 删除播放列表

先决条件

  • Node.js 18或更高版本
  • YouTube数据API v3访问
  • 谷歌云控制台帐户

安装

选项1：从npm安装（推荐）

npm install -g @a.ardeshir/youtube-mcp

选项2：从GitHub安装

git clone https://github.com/aardeshir/youtube-mcp.git
cd youtube-mcp
npm install

设置

1.设置YouTube API

第一步：创建谷歌云项目

  1. 首选 谷歌云控制台
  2. 创建新项目或选择现有项目
  3. 记下您的项目ID

步骤2：启用YouTube数据API v3

  1. 在谷歌云控制台中，转到“API和服务”>“库”
  2. 搜索“YouTube数据API v3”
  3. 点击它并按“启用”

常见问题：如果您看到“YouTube Data API v3以前未在项目中使用或已禁用”，请在启用后等待2-3分钟，以便进行传播。

步骤3：创建OAuth 2.0凭据

  1. 转到“API和服务”>“凭据”
  2. 点击“+创建证书”>“OAuth客户端ID”
  3. 如果出现提示，请配置OAuth同意屏幕：
    • 选择“外部”（或“内部”作为工作区）
    • 填写必填字段（应用程序名称、支持电子邮件）
    • 将您的电子邮件添加为测试用户
    • 对于范围，添加： https://www.googleapis.com/auth/youtube
  4. 对于应用程序类型，选择“Web应用程序”
  5. 添加授权重定向URI： http://localhost:8080/callback
  6. 保存并记录您的客户端ID和客户端密码

步骤4：获取API密钥（可选-用于只读访问）

  1. 转到“API和服务”>“凭据”
  2. 单击“+创建CREDENTIALS”>“API键”
  3. 将密钥限制为YouTube数据API v3

2.身份验证

运行OAuth安装向导：

如果通过npm安装：

youtube-mcp-setup

如果从GitHub安装：

npm run auth-setup

这将：

  1. 提示输入您的客户端ID和客户端密码
  2. 打开浏览器进行谷歌授权
  3. 自动生成刷新令牌
  4. 创建 .env 将您的凭据归档

3.配置克劳德桌面

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在Mac上）：

如果通过npm安装：

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "npx",
      "args": ["-y", "@a.ardeshir/youtube-mcp"],
      "env": {
        "YOUTUBE_API_KEY": "your-api-key",
        "YOUTUBE_CLIENT_ID": "your-client-id",
        "YOUTUBE_CLIENT_SECRET": "your-client-secret",
        "YOUTUBE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

如果从GitHub安装：

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "node",
      "args": ["/path/to/youtube-mcp/index.js"],
      "env": {
        "YOUTUBE_API_KEY": "your-api-key",
        "YOUTUBE_CLIENT_ID": "your-client-id",
        "YOUTUBE_CLIENT_SECRET": "your-client-secret",
        "YOUTUBE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

使用示例

搜索视频

Search YouTube for "piano tutorials"

创建播放列表

Create a YouTube playlist called "My Favorites"

列表播放列表

Show my YouTube playlists

故障排除

“YouTube Data API v3以前从未在项目中使用过”

  • 确保在Google云控制台中启用API
  • 等待2-3分钟以传播更改
  • 检查您使用的项目是否正确

“无效凭据”错误

  • 验证是否配置了OAuth同意屏幕
  • 确保添加了测试用户电子邮件
  • 检查重定向URI是否完全匹配： http://localhost:8080/callback

MCP未在Claude Desktop中连接

  • 检查所有环境变量是否已设置
  • 配置更改后重新启动Claude Desktop
  • 验证Node.js路径是否正确

“超出配额”错误

安全说明

  • 永不承诺 .env 文件到版本控制
  • 确保您的刷新令牌安全
  • 生产使用OAuth，API密钥仅用于测试
  • 定期轮换凭证

贡献

欢迎投稿！拜托：

  1. 分叉存储库
  2. 创建特征分支
  3. 提交拉取请求

许可证

MIT-见许可证文件

支持

对于问题和疑问：

致谢

内置：

相关 MCP