YouTube知识MCP
生产就绪的模型上下文协议（MCP）服务器，将YouTube转化为可查询的知识源。搜索、获取详细信息、分析成绩单/评论，并使用可选的LLM为AI工作流供电。专为Claude Desktop和其他MCP客户端构建。
为什么这很特别
- 快速+配额意识 带缓存的YouTube API访问
- 电池包括工具 搜索、详细信息、趋势、频道
- 可选的AI超级能力 （OpenAI/Anthropic）用于总结、主题、章节、学习路径、评论意图和知识图
- 零噪音：最小配置、清除日志、安全默认值
需求
- Node.js 18+
- YouTube数据API v3密钥
- 可选：人工智能工具的OpenAI和/或Anthropic API密钥
安装
npm install配置环境
创建 .env （或在MCP客户端配置中设置变量）。您可以从以下示例开始：
cp env.example .env然后在中设置值 .env:
# Required
YOUTUBE_API_KEY=your_youtube_api_key
# Optional AI providers (enables AI tools: analyze_video_content, generate_learning_path, analyze_comment_intents, simplify_video_transcript, generate_video_chapters, generate_knowledge_graph)
OPENAI_API_KEY=your_openai_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key
# Optional tuning
LOG_LEVEL=info
MAX_DAILY_QUOTA=8000
REDIS_URL= # e.g. redis://localhost:6379
REDIS_HOST=
REDIS_PORT=
REDIS_PASSWORD=一 env.example 带有占位符。不要承诺你的 .env.
构建并运行
# Development (watch)
npm run dev
# Production
npm run build
npm start连接到克劳德桌面（示例）
使用绝对路径添加到您的Claude Desktop配置中：
{
"mcpServers": {
"youtube-knowledge": {
"command": "node",
"args": ["/absolute/path/to/youtube-knowledge-mcp/build/index.js"],
"env": {
"YOUTUBE_API_KEY": "your_youtube_api_key",
"OPENAI_API_KEY": "optional_openai",
"ANTHROPIC_API_KEY": "optional_anthropic",
"LOG_LEVEL": "info"
}
}
}
}编辑配置后重新启动Claude Desktop。
可用工具
youtube_search--使用过滤器搜索视频get_video_details--视频元数据、文字记录（尽最大努力）、评论get_trending_videos--按地区/类别最受欢迎search_channels--使用可选统计数据进行频道搜索analyze_video_content--AI主题/情感/问题/总结/关键词generate_learning_path--一个主题的AI学习路径analyze_comment_intents--对观众意图进行分类simplify_video_transcript--ELI5样式简化generate_video_chapters--带有时间戳的AI章节generate_knowledge_graph--跨视频概念图
注意：只有配置了AI提供者密钥，AI工具才可用。
配额和安全
- 强制每日配额（默认8000个单位）和具有成本意识的人工智能使用
- 记录到stderr（不会破坏MCP stdio）
- 缓存减少了API和令牌支出；支持可选Redis
故障排除
- 缺少钥匙：确保
YOUTUBE_API_KEY已设置 - 超出配额：使用率降低、启用缓存或提高
MAX_DAILY_QUOTA - Claude无法连接：请验证到的绝对路径
build/index.js并重新启动
许可证
麻省理工学院 作者：埃菲·库塔