使用说明

YouTube MCP服务器（YouTube连接器MCP）

youtube-connector-mcp 是一个 YouTube MCP服务器/连接器 这使得AI助手能够 Claude、Cursor、Cline、Windsurf、Continue.dev、Grapes AI 与 YouTube数据API v3 通过 模型上下文协议（MCP）.

🌐 项目网址：https://youtube-connector-mcp-website.vercel.app/
📦 PyPI包：https://pypi.org/project/youtube-connector-mcp/

快速开始

# 1. Get your YouTube API Key from Google Cloud Console
#    https://console.cloud.google.com/apis/credentials

# 2. Set your API key as environment variable
export YOUTUBE_API_KEY="your_api_key_here"

# 3. Install pipx first (if not installed)
brew install pipx  # macOS
# or: apt install pipx  # Ubuntu/Debian

# 4. Install the package
pipx install youtube-connector-mcp

# 5. Add the MCP server
claude mcp add youtube-connector-mcp youtube-connector-mcp -s user -e YOUTUBE_API_KEY="${YOUTUBE_API_KEY}"

# 6. Restart Claude Code and start using!

先决条件

要求	如何获得
Python 3.10+	下载Python 或 `brew install python3`
YouTube API密钥	免费获取 Google 云控制台
MCP客户端	任何与MCP兼容的AI：克劳德, 光标, 克莱恩, 帆板运动, Continue.dev等等。

安装

从PyPI安装（推荐）

# Install pipx first (if not installed)
brew install pipx  # macOS
# or: apt install pipx  # Ubuntu/Debian

# Then install the package
pipx install youtube-connector-mcp

# Or with pip in a virtual environment
python3 -m venv .venv
source .venv/bin/activate
pip install youtube-connector-mcp

从源代码安装

git clone https://github.com/ShellyDeng08/youtube-connector-mcp.git
cd youtube-connector-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

验证安装

youtube-connector-mcp --help
claude mcp list  # Check if server is registered

配置

流行的AI编码工具

工具	平台	配置
克劳德代码	CLI	`claude mcp add`
克劳德桌面	macOS/Windows	`claude_desktop_config.json`
光标IDE	桌面	设置UI
克莱恩	VS代码扩展	`.cline/config.yaml`

注：任何兼容MCP的AI工具都可以！只需使用下面的标准JSON配置格式。

选项1：使用 `claude mcp add` （克劳德代码-最简单）

# Install for current project only
claude mcp add youtube-connector-mcp youtube-connector-mcp -s local -e YOUTUBE_API_KEY="${YOUTUBE_API_KEY}"

# Install for all your projects (recommended)
claude mcp add youtube-connector-mcp youtube-connector-mcp -s user -e YOUTUBE_API_KEY="${YOUTUBE_API_KEY}"

# Install to project's .mcp.json
claude mcp add youtube-connector-mcp youtube-connector-mcp -s project -e YOUTUBE_API_KEY="${YOUTUBE_API_KEY}"

没有API密钥？ 看创建YouTube API密钥下面-它是免费的，只需要几分钟。

选项2：标准JSON配置

适用于任何 MCP 兼容的 AI 工具

{
  "mcpServers": {
    "youtube-connector-mcp": {
      "command": "youtube-connector-mcp",
      "env": {
        "YOUTUBE_API_KEY": "your_api_key_here"
      }
    }
  }
}

各工具配置文件位置：

工具	配置文件路径
克劳德代码	`~/.claude/mcp_config.json`
克劳德桌面	`~/Library/Application Support/Claude/claude_desktop_config.json` （macOS）
光标IDE	设置→ MCP服务器（UI）
Cline（VS代码）	`.cline/config.yaml`

选项3：克劳德桌面

打开克劳德桌面
前往设置→ 开发者→ 编辑配置
或者直接编辑配置文件：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "youtube-connector-mcp": {
      "command": "youtube-connector-mcp",
      "env": {
        "YOUTUBE_API_KEY": "your_api_key_here"
      }
    }
  }
}

选项4：光标IDE

打开光标设置（Cmd/Ctrl+，）
首选 MCP服务器 部分
使用上面的JSON格式添加新服务器

选项5:Cline（VS代码扩展）

添加到您的 .cline/config.yaml:

mcpServers:
  youtube-connector-mcp:
    command: youtube-connector-mcp
    env:
      YOUTUBE_API_KEY: "your_api_key_here"

API密钥设置

设置为环境变量（推荐）：

# Linux/Mac - Add to ~/.bashrc, ~/.zshrc, or ~/.profile
export YOUTUBE_API_KEY="your_api_key_here"
source ~/.zshrc

# Windows PowerShell - Add to $PROFILE
$env:YOUTUBE_API_KEY="your_api_key_here"
# Or set permanently
[System.Environment]::SetEnvironmentVariable('YOUTUBE_API_KEY', 'your_api_key_here', 'User')

# Windows CMD
setx YOUTUBE_API_KEY "your_api_key_here"

或者直接放入MCP配置中：

{
  "mcpServers": {
    "youtube-connector-mcp": {
      "command": "youtube-connector-mcp",
      "env": {
        "YOUTUBE_API_KEY": "AIzaSyC-Your-Actual-API-Key-Here"
      }
    }
  }
}

安全说明： 使用环境变量更安全，因为它使您的密钥不受版本控制。

创建YouTube API密钥

首选 Google 云控制台
创建新项目或选择现有项目
启用 YouTube数据API v3
首选凭证并创建一个API密钥
（可选）将密钥限制为YouTube Data API v3以获得更好的安全性

环境变量

变量	必填	默认	描述
`YOUTUBE_API_KEY`	是	-	YouTube数据API v3密钥
`YOUTUBE_RATE_LIMIT`	否	100	每秒最大请求数

特性

核心能力

工具	说明
`youtube_search`	使用过滤器（持续时间、日期、类型、顺序）搜索视频、频道、播放列表
`youtube_get_video`	获取详细的视频元数据、统计数据、缩略图和内容详细信息
`youtube_get_channel`	获取频道信息、订阅者数量、上传播放列表、统计数据
`youtube_get_transcript`	检索带有时间戳的实际视频转录文本
`youtube_get_comments`	获取支持分页的视频评论
`youtube_get_playlist`	获取播放列表详细信息和完整的视频列表
`youtube_list_playlists`	列出特定频道的所有播放列表

用例

研究：以编程方式搜索和分析YouTube内容
内容分析：提取成绩单和评论以供人工智能处理
通道监控：跟踪频道统计和新上传
数据挖掘：为您的项目收集YouTube数据
自动化工作流程：将YouTube数据集成到人工智能辅助的工作流程中

使用示例

类别	示例提示
搜索	“搜索Python教程”/“查找最近的AI视频”/“拥有10万以上订阅者的烹饪频道”
视频	“获取此视频的详细信息：URL”/“观看次数是多少？”/“获取成绩单”
频道	“@MKBHD有多少订阅者？”/“此频道最近上传的内容”/“频道统计信息”
播放列表	“列出此频道的所有播放列表”/“获取此播放列表中的视频”

故障排除

未找到MCP服务器

错误： No MCP servers configured

解决：

验证 ~/.claude/mcp_config.json 存在
检查JSON语法是否有效
跑 claude mcp list 查看已注册的服务器
更新配置后重新启动Claude代码

找不到Python

错误： command not found: python

解决：

使用 python3 而不是 python
提供完整路径： which python3 （Mac/Linux）或 where python （Windows）

未找到模块

错误： ModuleNotFoundError: No module named 'mcp'

解决：

如果使用pipx: pipx reinstall youtube-connector-mcp
如果在venv中使用pip：首先激活虚拟环境 source .venv/bin/activate

超过API配额

错误： 403 Forbidden - quota exceeded

解决：

检查谷歌云控制台配额
默认值：10000单位/天
考虑升级以获得更高的限制

成绩单不可用

错误： “没有可用的成绩单”或“成绩单已禁用”

解决：

视频可能未启用字幕
上传后自动生成的字幕可能需要24小时以上
尝试一个已知有字幕的视频

成绩单请求被阻止

错误： “YouTube正在阻止来自您IP的请求”

解决： 看 youtube转录api文档用于代理选项。

发展

设置

git clone https://github.com/ShellyDeng08/youtube-connector-mcp.git
cd youtube-connector-mcp
poetry install --with dev

运行测试

poetry run pytest

发布到PyPI

# Bump version (PyPI doesn't allow re-uploading the same version)
poetry version patch  # 0.3.0 → 0.3.1
poetry version minor  # 0.3.0 → 0.4.0
poetry version major  # 0.3.0 → 1.0.0

# Build and publish
poetry build
poetry publish

许可证

MIT许可证-请参阅许可证了解详情。

链接

SEO关键词

YouTube MCP服务器、YouTube MCP连接器、MCP YouTube API、Claude MCP YouTube、Cursor MCP YouTube和AI YouTube API、模型上下文协议YouTube

使用说明

YouTube MCP服务器（YouTube连接器MCP）

快速开始

先决条件

安装

从PyPI安装（推荐）

从源代码安装

验证安装

配置

流行的AI编码工具

选项1：使用 claude mcp add （克劳德代码-最简单）

选项2：标准JSON配置

选项3：克劳德桌面

选项4：光标IDE

选项5:Cline（VS代码扩展）

API密钥设置

创建YouTube API密钥

环境变量

特性

核心能力

用例

使用示例

故障排除

未找到MCP服务器

找不到Python

未找到模块

超过API配额

成绩单不可用

成绩单请求被阻止

发展

设置

运行测试

发布到PyPI

许可证

链接

SEO关键词

相关 MCP

小红书MCP服务

Figma MCP集成工具

MCP 协议测试服务器

Flomo笔记服务

Unity编辑器AI集成插件

科学研究的开源MCP服务器

选项1：使用 `claude mcp add` （克劳德代码-最简单）