YouTube Semantic Search

🚀 YouTube MCP 服务器

YouTube MCP 服务器是一个强大的工具，它能直接搜索 YouTube 视频、获取视频字幕，还能对视频内容进行语义检索。借助模型上下文协议（MCP），为用户提供高效的视频搜索和内容分析体验。

🚀 快速开始

先决条件

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

安装

1. 克隆此仓库
2. 创建并激活虚拟环境（使用 uv）：

uv venv
# 在 Windows 上：
.venv\Scripts\activate
# 在 Unix/MacOS 上：
source .venv/bin/activate

3. 使用 uv 安装依赖项：

uv pip install -r requirements.txt

4. 创建一个 .env 文件并添加您的 Google API 密钥：

GOOGLE_API_KEY=your_api_key_here

运行服务器

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

1. 直接方法

在终端中运行以下命令启动服务器：

python server.py

2. 配置为 Claude.app 使用

将项目添加到 Claude.app 的插件目录中，并按照平台说明进行配置。

✨ 主要特性

• 无需使用官方 API 即可直接搜索 YouTube 视频。
• 能够获取视频字幕。
• 可将视频信息和字幕存储在向量数据库中。
• 支持对存储的视频字幕进行语义检索。

📦 安装指南

克隆仓库

克隆此仓库到本地。

创建并激活虚拟环境

使用 uv 创建并激活虚拟环境：

uv venv
# 在 Windows 上：
.venv\Scripts\activate
# 在 Unix/MacOS 上：
source .venv/bin/activate

安装依赖项

使用 uv 安装项目所需的依赖项：

uv pip install -r requirements.txt

配置 API 密钥

创建一个 .env 文件并添加您的 Google API 密钥：

GOOGLE_API_KEY=your_api_key_here

💻 使用示例

基础用法

from mcp_youtube import YouTubeMCPClient

client = YouTubeMCPClient()
results = client.search("人工智能")
print(results)

📚 详细文档

可用工具

• 搜索视频：通过关键词或过滤条件搜索 YouTube 视频。
• 获取字幕：提取指定视频的字幕内容。
• 存储信息：将视频信息和字幕存储到向量数据库中，便于后续检索。
• 语义检索：通过对存储的字幕进行语义分析，实现高效的视频检索。

与 MCP 客户端一起使用

使用 YouTubeMCPClient 类与 MCP 客户端进行交互，如上述示例所示。

🔧 技术细节

调试

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

📄 许可证

本项目在 MIT 许可证下发布，详细内容请参阅 LICENSE 文件。

支持我们

如果您发现此项目对您有帮助，并希望支持我们的未来项目，请考虑给我们买一杯咖啡！您的支持将帮助我们继续构建创新的人工智能解决方案。

您的贡献将极大地激励我们继续创造智能且用户友好的应用程序。

贡献

欢迎贡献！请随时提交拉取请求。