Youtube Uploader Mcp

YouTube Uploader MCP

AI 驱动的 YouTube 上传工具——无需命令行、无需 YouTube Studio，密钥绝不与 LLM 或第三方应用共享，而且完全免费！它包含 OAuth2 认证、令牌管理和视频上传功能。

功能特性

• 直接上传：从 Claude、Cursor、VS Code 或任何其他 MCP 客户端将视频上传到 YouTube。
• AI 辅助元数据：通过你的 MCP 客户端自动生成标题、描述和标签。
• OAuth2 认证：安全的本地登录、多频道支持和自动刷新。
• 元数据与设置：分类标签、可选语言设置和显式元数据控制。
• 隐私与定时发布：支持公开、私密或不公开列出状态，以及定时发布时间。
• 上传后配置（update_video）：将视频添加到播放列表、上传自定义缩略图（<2MB）、附加字幕、为已上传的视频安排发布时间，以及更新面向儿童设置。

单命令安装

适用于 Mac 和 Linux

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/anwerj/youtube-uploader-mcp/master/scripts/install.sh)"

适用于 Windows（Powershell）

Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/anwerj/youtube-uploader-mcp/master/scripts/install.ps1" -OutFile "$env:TEMP\install.ps1"; PowerShell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\install.ps1"

预期结果

这一条命令将

1. 帮助下载 oAuth 客户端密钥文件（如果尚未下载），
2. 下载 MCP 服务，
3. 设置运行 MCP 服务所需的最低权限，
4. 自动更新 Cluade Desktop 配置，加入 youtube-uploader-mcp 服务，并且
5. 最后打印适用于任何其他客户端（VS Code/Cursor/AnythingLLM 等）的确切 MCP 配置。

演示

设置与演示视频

手动安装

请查看 单命令安装，如果你更倾向于手动安装，请继续。

访问 Releases 页面，下载适合你操作系统的二进制文件：

• youtube-uploader-mcp-linux-amd64
• youtube-uploader-mcp-darwin-arm64
• youtube-uploader-mcp-windows-amd64.exe
• 等等。

你可以使用最新的版本标签，例如 v1.0.0。

---

2. 使其可执行（Linux/macOS）

chmod +x path/to/youtube-uploader-mcp-<os>-<arch>

3. 配置 MCP（例如在 Claude Desktop 或 Cursor 中）

{
  "mcpServers": {
    "youtube-uploader-mcp": {
      "command": "/absolute/path/to/youtube-uploader-mcp-<os>-<arch>",
      "args": [
        "-client_secret_file",
        "/absolute/path/to/client_secret.json(See Below)"
      ]
    }
  }
}

4. 设置 Google OAuth 2.0

要上传到 YouTube，你必须配置 OAuth 并从 Google Developer Console 获取 client_secret.json 文件。

➡️ 按照 youtube_oauth2_setup.md 中的指南进行分步操作。

警告

重要：敏感 OAuth 权限范围与重新认证： 字幕/说明文字上传依赖于 https://www.googleapis.com/auth/youtube.force-ssl 权限范围，这是 YouTube Data API 执行字幕写入操作所必需的。

• 现有用户：如果你使用此 MCP 的旧版本进行了认证，保存的令牌将缺少此权限范围。任何尝试上传字幕的调用都会因 403 Forbidden API 错误而失败。
• 如何更新：你必须删除频道缓存文件（通常是你工作目录中的 .youtube_uploader_channels_cache），并重新运行 authenticate 工具以授予新权限。
• Google Console 警告：添加此敏感权限范围会在 Google Cloud Console 中触发警告界面。由于这是供你个人使用，你可以安全地跳过“未验证应用”警告继续操作。

用法与工具编排

MCP 服务注册以下工具：

1. authenticate：生成用于身份验证的 OAuth2 URL。
2. accesstoken：用授权码换取用户凭据和频道信息。
3. channels：获取已通过身份验证的频道。
4. refreshtoken：强制刷新令牌。
5. upload_video：上传视频文件并配置主要信息（标题、描述、标签、分类、可选语言、状态、儿童标志、定时发布）。
6. update_video：解耦的工具，管理上传后的配置：将视频添加到播放列表、上传自定义缩略图（必须 <2MB）、附加字幕/隐藏式字幕轨道、将现有的私享视频定时在 RFC3339 时间发布，以及更新面向儿童的受众设置。
7. list_videos：列出上传到某个频道的视频（公开、不公开列出和私享），支持可选的标题/描述搜索、隐私过滤和日期排序。

贡献

请参阅 CONTRIBUTING.md 了解如何贡献。