🚀 YouTube MCP 服务器

本项目是一个模型上下文协议（MCP）服务器，可用于搜索 YouTube 视频、获取视频字幕，还能对视频内容进行语义搜索，为用户提供便捷的视频信息获取与处理方案。

🚀 快速开始

功能

• 不使用官方 API 直接搜索 YouTube 视频
• 获取视频字幕
• 将视频信息和字幕存储在向量数据库中
• 对存储的视频字幕进行语义搜索

先决条件

• 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

运行服务器

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

1. 直接方法

直接启动 MCP 服务器：

uv run python server.py

2. 配置为 Claude.app 使用

添加到你的 Claude 设置中，无需使用任何包管理器（适用于 Windows）：

"mcpServers": {
  "youtube": {
    "command": "C:\\路径\\to\\your\\uv",
    "args": ["run", "python", "server.py"]
  }
}

💻 使用示例

基础用法

要将此服务器与 MCP 客户端集成，请参考 MCP 协议文档。以下是一个简单的示例：

1. 启动服务器：

uv run python server.py

2. 在你的 MCP 客户端中配置 YouTube MCP 服务器地址。

🔧 技术细节

可用工具

• server.py：MCP 服务器主文件，用于处理连接和请求。
• config.json：服务器配置文件，包含端点地址和其他设置。

调试

如果遇到问题，请按照以下步骤进行排查：

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

🤝 贡献

欢迎贡献！请随意提交 Pull Request。

📄 许可证

此项目 licensed under the MIT License - 有关详细信息，请参阅 LICENSE 文件。

🌟 支持我们

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

你的贡献极大地激励了我们为创建智能且用户友好的应用程序而不懈努力。