Youtube Connector MCP

MCP音视频

提供方 ShellyDeng08

音视频 stdio · 本地进程 API Key 社区 / 第三方 ClaudeCursorWindsurfCline
查看接入方式

一个通过模型上下文协议(MCP)连接AI助手与YouTube Data API v3的服务,支持视频搜索、元数据获取、字幕提取等功能。

一句话选型结论

按资料字段整理

Youtube Connector MCP 属于音视频类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude、Cursor、Windsurf 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类音视频 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 71 仓库热度,无公开仓库时显示未标注
工具数 7 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

音视频
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量7暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

YouTubeAPIPython本地部署AI集成数据采集视频分析自动化工具

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
python3 -m venv .venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 7 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
转写与字幕

把音视频转成文字和字幕。

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 7 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、Windsurf,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在音视频场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Youtube Connector MCP当前 7 stdio · 本地进程 本地部署 有 2026-05-17
Ableton MCP B7b69a6a 16 stdio · 本地进程 本地部署 有 2026-05-17
Mini Max MCP 8 SSE · 服务端推送 远程部署 有 2026-05-18
LocalAI 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Youtube E0eb3510 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Voicemode MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

音视频
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ShellyDeng08上游标注的维护方 ShellyDeng08
分类音视频本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.5 KB
来自项目仓库与上游目录的原文,未做删改

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/


快速开始```bash

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安装(推荐)```bash
# 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

从源代码安装```bash

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 .


### 验证安装```bash
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 (克劳德代码-最简单)```bash

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 工具**```json
{
"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:克劳德桌面

  1. 打开克劳德桌面
  2. 前往设置→ 开发者→ 编辑配置
  3. 或者直接编辑配置文件:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
窗户: `%APPDATA%\Claude\claude_desktop_config.json````json
{
"mcpServers": {
"youtube-connector-mcp": {
"command": "youtube-connector-mcp",
"env": {
"YOUTUBE_API_KEY": "your_api_key_here"
}
}
}
}


### 选项4:光标IDE

1. 打开光标设置(Cmd/Ctrl+,)
1. 首选 **MCP服务器** 部分
1. 使用上面的JSON格式添加新服务器

### 选项5:Cline(VS代码扩展)

添加到您的 `.cline/config.yaml`:```yaml
mcpServers:
youtube-connector-mcp:
command: youtube-connector-mcp
env:
YOUTUBE_API_KEY: "your_api_key_here"

API密钥设置

设置为环境变量(推荐):```bash

Linux/Mac - Add to ~/.bashrc, ~/.zshrc, or ~/.profile

export YOUTUBE_API_KEY="your_api_key_here"
source ~/.zshrc
``````powershell

Windows PowerShell - Add to $PROFILE

$env:YOUTUBE_API_KEY="your_api_key_here"

Or set permanently

``````cmd

Windows CMD

setx YOUTUBE_API_KEY "your_api_key_here"


**或者直接放入MCP配置中:**```json
{
"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_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

解决:

  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文档 用于代理选项。


发展

设置```bash

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


### 运行测试```bash
poetry run pytest

发布到PyPI```bash

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


链接

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

SEO关键词

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

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Youtube Connector MCP 怎么安装?

在客户端按下面的安装命令接入:python3 -m venv .venv。装完在客户端配置里引用同一个包或端点。

Youtube Connector MCP 怎么在 Claude、Cursor、Windsurf 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Youtube Connector MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Youtube Connector MCP 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Youtube Connector MCP 支持哪些客户端?

资料标注支持 Claude、Cursor、Windsurf、Cline;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Youtube Connector MCP 能提供哪些能力?

资料显示约 7 个工具;能力标签包括 视频分析、Python、Claude。具体工具清单以官方文档为准。

Youtube Connector MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Youtube Connector MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。