适合谁
- 需要减少 token 消耗的 LLM 代理。
- 需要频繁访问 YouTube 数据并希望保护 API 配额的用户。
- 需要高质量、经过充分测试的 MCP 服务器的开发者。
Y
62FMRS · C
该服务器因其 token 优化设计而备受好评，能大幅减少上下文窗口占用。缓存机制能有效保护 API 配额。代码质量高，测试覆盖率达 97%，维护活跃。适合生产环境使用，但需注意非官方性质及潜在配额消耗。
YouTube Data MCP Server（@kirbah/mcp-youtube）是一个生产级别的 MCP 服务器，专为 AI 代理设计，通过 YouTube Data API v3 获取结构化数据。它优化了 token 使用，可节省高达 87% 的上下文窗口，支持智能缓存以保护 API 配额，并拥有高测试覆盖率。提供多种工具，如获取视频详情、搜索视频、获取字幕、频道统计、趋势视频等。支持零配置模式（无需 API 密钥即可获取字幕），并可配置 MongoDB 缓存以进一步节省配额。
工具能力
getVideoDetails
获取多个 YouTube 视频的详细、精简信息，包括元数据、统计数据和互动率。
searchVideos
根据查询字符串搜索视频或频道，返回简洁结果。
getTranscripts
获取多个视频的 token 高效字幕，支持全文或关键片段。
getChannelStatistics
获取多个频道的精简统计（订阅者、观看次数、视频数量等）。
getChannelTopVideos
获取某个频道表现最好的视频列表，附带精简信息和互动率。
getTrendingVideos
按地区和类别获取趋势视频列表，附带精简信息和互动率。
getVideoCategories
获取指定地区可用的 YouTube 视频类别（ID 和标题）。
getVideoComments
获取视频评论，可排序、限制数量，并可获取少量回复。
findConsistentOutlierChannels
识别在特定利基市场中持续表现超常的频道（需要 MongoDB 连接）。
安装接入
- 零配置模式：在 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"]
}
}
}
选型与风险
不适合谁
- 需要原始、未优化的 YouTube API 响应（包括所有嵌套字段）的用户。
- 需要实时或高频率更新的数据（缓存可能延迟）。
- 没有 MongoDB 希望使用 `findConsistentOutlierChannels` 工具的用户。
所需权限
- 网络访问 YouTube Data API v3。
- 可选：访问环境变量中的 API 密钥。
- 可选：访问 MongoDB 连接字符串以进行缓存。
风险与副作用
- API 密钥泄露风险：密钥存储在环境变量中，如果配置不当可能被意外提交。
- API 配额耗尽：尽管做了优化，搜索类工具仍消耗较多配额单元（如搜索 100 单位）。
- 数据缓存可能返回过期信息，如果不需缓存需避免启用 MongoDB。
- 依赖第三方服务器（非官方），可能随 YouTube API 变化而更新。
常见排障
- 常见问题：
- - 如果工具调用失败，检查 `YOUTUBE_API_KEY` 是否正确设置且未过期。
- - 确保网络能访问 Google API。
- - 如果启用 MongoDB 缓存，检查连接字符串是否有效。
- - 出现配额错误时，查看 Google Cloud Console 的配额用量。
使用场景
内容创作者分析自己的频道数据以优化策略。
营销人员研究趋势视频和热门频道。
开发者构建需要视频元数据或字幕的 AI 应用。
研究人员分析评论情感和互动率。
支持客户端
Claude Desktop完整支持
Cursor部分支持