Youtube Knowledge MCP

🚀 YouTube Knowledge MCP

这是一个可投入生产使用的模型上下文协议（MCP）服务器，它能将YouTube转变为一个可查询的知识源。你可以在其中进行搜索、获取详情、分析视频字幕和评论，还能借助可选的大语言模型（LLM）来驱动人工智能工作流。该项目专为Claude Desktop和其他MCP客户端打造。

🚀 快速开始

YouTube Knowledge MCP 是一个强大的工具，能让你以更智能的方式利用 YouTube 上的知识。以下是使用该项目的基本步骤。

✨ 主要特性

• 快速且支持配额管理：通过缓存机制实现快速的YouTube API访问。
• 集成丰富工具：提供搜索、获取详情、热门视频、频道搜索等工具。
• 可选的AI能力：借助OpenAI/Anthropic等AI服务，可实现视频内容总结、主题分析、章节生成、学习路径规划、评论意图分析和知识图谱构建等功能。
• 零干扰：配置简单，日志清晰，默认设置安全可靠。

📦 安装指南

环境要求

• Node.js 18 及以上版本
• YouTube Data API v3 密钥
• 可选：用于AI工具的OpenAI和/或Anthropic API密钥

安装依赖

npm install

配置环境变量

创建 .env 文件（或者在你的MCP客户端配置中设置变量）。你可以从示例文件开始：

cp env.example .env

然后在 .env 中设置相应的值：

# 必需
YOUTUBE_API_KEY=your_youtube_api_key

# 可选的AI提供商（启用AI工具：分析视频内容、生成学习路径、分析评论意图、简化视频字幕、生成视频章节、生成知识图谱）
OPENAI_API_KEY=your_openai_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key

# 可选调整
LOG_LEVEL=info
MAX_DAILY_QUOTA=8000
REDIS_URL= # 例如 redis://localhost:6379
REDIS_HOST=
REDIS_PORT=
REDIS_PASSWORD=

项目提供了带有占位符的 env.example 文件。注意，不要将你的 .env 文件提交到版本控制系统。

构建和运行

# 开发模式（实时监听文件变化）
npm run dev

# 生产模式
npm run build
npm start

连接到Claude Desktop（示例）

在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：可带统计信息搜索频道。

高级用法

如果配置了AI提供商密钥，还能使用以下高级AI工具：

• analyze_video_content：进行AI主题分析、情感分析、问题提取、内容总结和关键词提取。
• generate_learning_path：生成特定主题的AI学习路径。
• analyze_comment_intents：对观众评论意图进行分类。
• simplify_video_transcript：以简单易懂的方式简化视频字幕。
• generate_video_chapters：生成带时间戳的AI视频章节。
• generate_knowledge_graph：构建跨视频的概念知识图谱。

🔧 技术细节

配额和安全

• 实施每日配额限制（默认8000单位），并支持成本感知的AI使用。
• 日志输出到标准错误输出（不会干扰MCP的标准输入输出）。
• 缓存机制可减少API调用和令牌消耗，支持可选的Redis缓存。

故障排除

• 缺少密钥：确保已设置 YOUTUBE_API_KEY。
• 配额超限：降低使用频率、启用缓存或提高 MAX_DAILY_QUOTA。
• Claude无法连接：验证 build/index.js 的绝对路径并重启。

📄 许可证

本项目采用MIT许可证。 作者：Efi Kuta