Youtube Connector MCP

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

](https://lobehub.com/mcp/shellydeng08-youtube-connector-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!

______________________________________________________________________

先决条件

______________________________________________________________________

安装

从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编码工具

注： 任何兼容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"
      }
    }
  }
}

各工具配置文件位置：

______________________________________________________________________

选项3：克劳德桌面

1. 打开克劳德桌面
2. 前往设置→ 开发者→ 编辑配置
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

1. 打开光标设置（Cmd/Ctrl+，）
2. 首选 MCP服务器 部分
3. 使用上面的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密钥

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

环境变量

______________________________________________________________________

特性

核心能力

用例

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

______________________________________________________________________

使用示例

______________________________________________________________________

故障排除

未找到MCP服务器

错误： No MCP servers configured

解决：

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

找不到Python

错误： command not found: python

解决：

1. 使用 python3 而不是 python
2. 提供完整路径： 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

解决：

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

成绩单不可用

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

解决：

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

成绩单请求被阻止

错误： “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许可证-请参阅 许可证 了解详情。

______________________________________________________________________

链接

• 官方网站
• PyPI包
• YouTube数据API v3文档
• 克劳德代码

SEO关键词

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