YouTube MCP 服务器

一个提供搜索YouTube视频、获取字幕以及对视频内容进行语义搜索工具的模型上下文协议（MCP）服务器。

支持我们

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

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

目录

• YouTube MCP 服务器
• 功能
• 先决条件
• 安装
• 运行服务器
  • 1. 直接方法
  • 2. 配置为Claude.app使用
• 可用工具
• 与MCP 客户端一起使用
  • 示例用法
• 调试
• 贡献
• 许可证

功能

• 不使用官方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"]
  }
}

可用工具

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

与MCP 客户端一起使用

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

示例用法

1. 启动服务器：

uv run python server.py

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

调试

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

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

贡献

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

许可证

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