YouTube MCP Server

YouTube MCP 服务

一个 MCP（Model Context Protocol）服务，可通过 Claude Desktop 或任何兼容 MCP 的客户端将视频上传到 YouTube。

功能

• 📹 上传视频：将视频文件上传到 YouTube，并自定义元数据
• 🔐 OAuth2 身份验证：通过 YouTube API 安全地进行身份验证
• 📊 配额检查：监控 YouTube API 使用情况
• 📝 类别列表：浏览可用的视频类别
• 🔧 轻松设置：内置凭据配置工具

前提条件

• Python 3.10 或更高版本
• 已启用 YouTube Data API v3 的 Google Cloud Project
• Google Cloud Console 中的 OAuth2 凭据
• Claude Desktop（或其他 MCP 客户端）

设置说明

1. 安装依赖项

# Clone or download this repository
cd youtube-mcp-server

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On macOS/Linux:
source venv/bin/activate
# On Windows:
# venv\Scripts\activate

# Install required packages
pip install -r requirements.txt

2. 设置 Google Cloud 凭据

1. 前往 Google Cloud Console
2. 创建新项目或选择现有项目
3. 启用 YouTube Data API v3：
   • 前往“APIs & Services”>“Library”
   • 搜索“YouTube Data API v3”
   • 点击“Enable”
4. 创建 OAuth2 凭据：
   • 前往“APIs & Services”>“Credentials”
   • 点击“Create Credentials”>“OAuth client ID”
   • 将应用类型选为“Desktop app”
   • 下载凭据 JSON 文件

3. 配置 Claude Desktop

将服务添加到 Claude Desktop 配置中：

macOS/Linux：

# Open config file
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows：

code $env:AppData\Claude\claude_desktop_config.json

添加以下配置：

{
    "mcpServers": {
        "youtube-uploader": {
            "command": "python",
            "args": [
                "/ABSOLUTE/PATH/TO/youtube-mcp-server/youtube_uploader.py"
            ]
        }
    }
}

4. 首次身份验证

1. 重启 Claude Desktop
2. 使用 setup_youtube_auth 工具并提供 OAuth2 凭据：
   • 提供下载的 JSON 文件中的 client_id、client_secret 和 project_id
3. 尝试上传视频——浏览器窗口将打开以进行身份验证
4. 授予对 YouTube 账号的访问权限

可用工具

1. upload_video

将视频文件上传到 YouTube。

参数：

• file_path（必需）：视频文件路径
• title（必需）：视频标题
• description：视频描述
• keywords：以逗号分隔的标签
• category_id：YouTube 类别 ID（默认值：22）
• privacy_status：“private”、“unlisted”或“public”（默认值：private）
• made_for_kids：用于 COPPA 合规的布尔值

示例：

Upload the video at /Users/me/video.mp4 with title "My Amazing Video" and description "This is a test upload"

2. check_upload_quota

检查 YouTube API 配额使用情况和频道信息。

3. list_video_categories

列出特定地区可用的 YouTube 视频类别。

参数：

• region_code：ISO 国家/地区代码（默认值：US）

4. setup_youtube_auth

配置用于访问 YouTube API 的 OAuth2 凭据。

重要说明

• 配额限制：YouTube API 有每日配额。每次上传约消耗 1,600 个单位，每日配额为 1,600,000 个单位。
• 文件大小：大文件可能需要较长时间上传。服务使用可恢复上传。
• 隐私：为确保安全，视频默认以“private”状态上传。
• 身份验证：OAuth2 令牌存储在本地的 token.json 中。

故障排除

1. “缺少 credentials.json”：先运行 setup_youtube_auth
2. 身份验证错误：删除 token.json 并重新进行身份验证
3. 上传失败：检查文件路径、大小和格式
4. 超出配额：等待 24 小时，直到配额重置

安全性

• 妥善保管 credentials.json 和 token.json 文件
• 不要将这些文件提交到版本控制中
• OAuth2 令牌会过期；服务会自动刷新令牌

许可证

MIT 许可证