🚀 YouTube MCP 服务器
YouTube MCP 服务器是一个强大的工具，它能直接搜索 YouTube 视频、获取视频字幕，还能对视频内容进行语义检索。借助模型上下文协议（MCP），为用户提供高效的视频搜索和内容分析体验。
🚀 快速开始
先决条件
- Python 3.8+
- Google API 密钥用于嵌入
- uv 包管理器
安装
- 克隆此仓库
- 创建并激活虚拟环境（使用 uv）：
uv venv
# 在 Windows 上：
.venv\Scripts\activate
# 在 Unix/MacOS 上：
source .venv/bin/activate
- 使用 uv 安装依赖项：
uv pip install -r requirements.txt
- 创建一个
.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 客户端进行交互，如上述示例所示。
🔧 技术细节
调试
- 确保
.env文件中包含正确的 Google API 密钥。 - 检查所有依赖项是否已正确安装。
- 验证服务器是否正在运行并侦听连接。
- 查看服务器输出中的任何错误信息。
📄 许可证
本项目在 MIT 许可证下发布，详细内容请参阅 LICENSE 文件。
支持我们
如果您发现此项目对您有帮助，并希望支持我们的未来项目，请考虑给我们买一杯咖啡！您的支持将帮助我们继续构建创新的人工智能解决方案。
您的贡献将极大地激励我们继续创造智能且用户友好的应用程序。
贡献
欢迎贡献！请随时提交拉取请求。