← 返回目录

YouTube Data MCP Server

社区

为 AI 代理优化的高效 YouTube 数据 MCP 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 57 / 230
Stars: ★ 32 热门
传输方式: stdio（本地进程）
运行环境: Node.js 20+
凭据: 可选 API Key
许可证: MIT
最近提交: 13 天前
工具数: 9

62FMRS · C

该服务器因其 token 优化设计而备受好评，能大幅减少上下文窗口占用。缓存机制能有效保护 API 配额。代码质量高，测试覆盖率达 97%，维护活跃。适合生产环境使用，但需注意非官方性质及潜在配额消耗。

最强项 · 安装易用性 14/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

12/20

文档质量

14/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: README声称97%测试覆盖率、CI徽章、Zod输入校验和MCP官方starter架构，但这属于不可信的README证据，静态审查中未提供实际的测试文件或CI工作流内容，无法验证关键路径覆盖。工具清单结构清晰、配额成本披露详细，声明合理，但错误处理和降级行为（如MongoDB不可用时、API key缺失时各工具行为）仅有部分描述（findConsistentOutlierChannels在无MongoDB时不可用）。扣分：缺少可验证的执行证据。
安全与权限 12/20: API密钥通过环境变量传递且标记为secret，README明确要求限制API密钥权限并提醒勿提交密钥，未发现真实token泄露、恶意代码或越权行为。扣分：MongoDB连接字符串也标记为secret但作为可选缓存层，其数据边界（远端缓存内容、访问控制）未充分披露；findConsistentOutlierChannels会对YouTube进行多次批量查询，网络行为披露有限。无红线风险。
维护活跃度 12/20: v1.1.13、非归档、有1个开放issue、声明Dependabot自动补丁和CI，MIT许可证明确，版本号与npm包一致。扣分：实际提交频率、issue响应时间、发布节奏和安全响应渠道均无源码证据支持，26星规模较小，治理信息不完整。
文档质量 14/20: 文档质量较高：安装、API密钥申请步骤、每个工具的参数与配额成本逐项披露、Windows兼容提示、本地开发流程、MongoDB缓存说明和安全注意事项齐备，含示例与对比数据。扣分：token节省数字为README自述未经验证；文档内部不一致——工具表列出findConsistentOutlierChannels参数为niche/minVideos/maxChannels，而深入章节描述的是query/channelAge等不同参数集，存在矛盾；缺少故障排查章节。
安装易用性 14/20: 提供零配置模式和Claude Desktop/Cursor的JSON配置示例，npx一键运行，Windows PowerShell备选方案，.env.example模板，步骤清晰。扣分：npx运行方式的启动速度与Node >=20版本前提是常见脆弱点，本地开发需绝对working_directory，静态审查无法验证安装路径实际可用，按校准规则不超过15。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

需要减少 token 消耗的 LLM 代理。
需要频繁访问 YouTube 数据并希望保护 API 配额的用户。
需要高质量、经过充分测试的 MCP 服务器的开发者。

不适合谁

需要原始、未优化的 YouTube API 响应（包括所有嵌套字段）的用户。
需要实时或高频率更新的数据（缓存可能延迟）。
没有 MongoDB 希望使用 `findConsistentOutlierChannels` 工具的用户。

所需权限

网络访问 YouTube Data API v3。
可选：访问环境变量中的 API 密钥。
可选：访问 MongoDB 连接字符串以进行缓存。

风险与副作用

API 密钥泄露风险：密钥存储在环境变量中，如果配置不当可能被意外提交。
API 配额耗尽：尽管做了优化，搜索类工具仍消耗较多配额单元（如搜索 100 单位）。
数据缓存可能返回过期信息，如果不需缓存需避免启用 MongoDB。
依赖第三方服务器（非官方），可能随 YouTube API 变化而更新。

安装接入

准备工作

运行环境：Node.js 20+

YOUTUBE_API_KEY 可选密钥 YouTube Data API v3 密钥，在 Google Cloud Console 中启用 YouTube Data API v3 并创建 API key 获取；可选，用于解锁搜索和频道分析等工具。

MDB_MCP_CONNECTION_STRING 可选密钥 MongoDB 连接字符串，用于缓存和 findConsistentOutlierChannels 工具；可从 MongoDB Atlas 免费获取，可选配置。

零配置模式：在 MCP 客户端中配置命令 npx -y @kirbah/mcp-youtube，无需 API 密钥即可获取字幕。
完整功能：前往 Google Cloud Console 启用 YouTube Data API v3 并创建 API 密钥。可选：创建免费的 MongoDB 连接字符串用于缓存。
在客户端配置中设置环境变量 YOUTUBE_API_KEY 和 MDB_MCP_CONNECTION_STRING。

示例配置：

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "@kirbah/mcp-youtube"],
      "env": {
        "YOUTUBE_API_KEY": "YOUR_KEY",
        "MDB_MCP_CONNECTION_STRING": "mongodb+srv://..."
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "@kirbah/mcp-youtube"]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "youtube": {
      "command": "npx",
      "args": [
        "-y",
        "@kirbah/mcp-youtube"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add youtube -- npx -y @kirbah/mcp-youtube

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中确认出现 getVideoDetails、searchVideos、getTranscripts 等工具，或直接让 AI 读取某个视频 ID 的字幕；若返回了转录文本，说明连接成功。

常见排障

常见问题：
- 如果工具调用失败，检查 `YOUTUBE_API_KEY` 是否正确设置且未过期。
- 确保网络能访问 Google API。
- 如果启用 MongoDB 缓存，检查连接字符串是否有效。
- 出现配额错误时，查看 Google Cloud Console 的配额用量。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我读取这个视频的字幕：dQw4w9WgXcQ
搜索关于 'home espresso setup' 的视频，返回前 5 个结果
获取频道 UC_x5XG1OV2P6uZZ5FSM9Ttw 的订阅数、总观看次数和视频数
获取美国地区当前的热门视频列表

工具能力 9

getVideoDetails 只读

获取多个 YouTube 视频的详细、精简信息，包括元数据、统计数据和互动率。

searchVideos 只读

根据查询字符串搜索视频或频道，返回简洁结果。

getTranscripts 只读

获取多个视频的 token 高效字幕，支持全文或关键片段。

getChannelStatistics 只读

获取多个频道的精简统计（订阅者、观看次数、视频数量等）。

getChannelTopVideos 只读

获取某个频道表现最好的视频列表，附带精简信息和互动率。

getTrendingVideos 只读

按地区和类别获取趋势视频列表，附带精简信息和互动率。

getVideoCategories 只读

获取指定地区可用的 YouTube 视频类别（ID 和标题）。

getVideoComments 只读

获取视频评论，可排序、限制数量，并可获取少量回复。

展开其余 1 个工具

findConsistentOutlierChannels 只读

识别在特定利基市场中持续表现超常的频道（需要 MongoDB 连接）。

使用场景

内容创作者分析自己的频道数据以优化策略。

营销人员研究趋势视频和热门频道。

开发者构建需要视频元数据或字幕的 AI 应用。

研究人员分析评论情感和互动率。

支持客户端

Claude Desktop

Cursor部分支持

依据项目文档列出，未经本站实测。

详细介绍

YouTube Data MCP Server（@kirbah/mcp-youtube）是一个生产级别的 MCP 服务器，专为 AI 代理设计，通过 YouTube Data API v3 获取结构化数据。它优化了 token 使用，可节省高达 87% 的上下文窗口，支持智能缓存以保护 API 配额，并拥有高测试覆盖率。提供多种工具，如获取视频详情、搜索视频、获取字幕、频道统计、趋势视频等。支持零配置模式（无需 API 密钥即可获取字幕），并可配置 MongoDB 缓存以进一步节省配额。