AI导哈

YouTube视频搜索与语义分析服务

一个提供YouTube视频搜索、字幕提取及语义分析功能的模型上下文协议服务器。

  • by IA-Programming
  • Python
  • 本地部署
  • 43 星标
  • 更新于
在 GitHub 查看 IA-Programming/Youtube-MCP

使用说明

YouTube MCP服务器

一种模型上下文协议（MCP）服务器，提供用于搜索YouTube视频、检索转录本和对视频内容执行语义搜索的工具。

支持我们

如果你觉得这个项目很有帮助，并想支持未来的项目，可以考虑给我们买杯咖啡！您的支持有助于我们继续构建创新的人工智能解决方案。

您的贡献在很大程度上激发了我们创建智能和用户友好应用程序的热情。

目录

特性

  • 在不使用官方API的情况下搜索YouTube视频
  • 检索视频记录
  • 将视频信息和转录本存储在矢量数据库中
  • 对存储的视频记录执行语义搜索

先决条件

  • Python 3.8+
  • 用于嵌入的Google API密钥
  • uv包管理器

安装

  1. 克隆此存储库

  2. 使用uv创建和激活虚拟环境：

uv venv
# On Windows:
.venv\Scripts\activate
# On Unix/MacOS:
source .venv/bin/activate
  1. 使用uv安装依赖项：
uv pip install -r requirements.txt
  1. 创建一个 .env 使用您的Google API密钥文件：
GOOGLE_API_KEY=your_api_key_here

运行服务器

有两种方法可以运行MCP服务器：

1.直接法

要直接启动MCP服务器：

uv run python server.py

2.配置Claude.app

在不使用任何软件包管理器的情况下添加到您的Claude设置中，这适用于windows：

"mcpServers": {
  "youtube": {
    "command": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts\\python.exe",
    "args": ["C:\\Path\\To\\Your\\Project\\server.py"],
    "env": {
      "GOOGLE_API_KEY": "your_api_key_here"
    }
  }
}

使用Uv包管理器，这适用于windows：

"mcpServers": {
  "youtube": {
    "command": "uv",
    "args": ["--directory", "C:\\Path\\To\\Your\\Project", "run", "server.py"],
    "env": {
      "GOOGLE_API_KEY": "your_api_key_here"
    }
  }
}

可用工具

服务器提供以下工具：

  1. search-youtube：根据查询搜索YouTube视频

    • 参数：
      • query：搜索查询字符串
      • max_results：返回的最大结果数（默认值：5）

  2. get-transcript：获取YouTube视频的文字记录

    • 参数：
      • video_url:YouTube视频的url

  3. store-video-info：将视频信息和文字记录存储在矢量数据库中

    • 参数：
      • video_url:YouTube视频的url
      • 元数据：关于视频的可选元数据

  4. search-transcripts：使用语义搜索搜索存储的视频转录

    • 参数：
      • 查询：搜索查询
      • limit：要返回的最大结果数（默认值：3）

与MCP客户端一起使用

此服务器可以与任何兼容MCP的客户端一起使用，例如Claude Desktop App。这些工具将被自动发现并提供给客户。

示例用法

  1. 使用上述方法之一启动服务器
  2. 打开克劳德桌面应用程序
  3. 查找锤子图标以验证YouTube工具是否可用
  4. 现在，您可以使用以下命令：
    • “搜索Python教程视频”
    • “获取此视频的文字记录：[video_url]”
    • “搜索存储的机器学习视频记录”

调试

如果您遇到任何问题：

  1. 确保您的Google API密钥在 .env 文件
  2. 检查是否正确安装了所有依赖项
  3. 验证服务器是否正在运行并侦听连接
  4. 在服务器输出中查找任何错误消息

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP