mcp-server-youtube

🚀 MCP YouTube 服务器

这是一个简单的模型上下文协议（MCP）服务器，为用户提供了与 YouTube 交互的实用工具。借助该服务器，MCP 主机应用程序（如桌面版的 Claude）能够轻松实现以下功能：

• 搜索 YouTube 视频。
• 获取特定 YouTube 视频的详细信息。

🚀 快速开始

本服务器允许 MCP 主机应用程序与 YouTube 进行交互，你可以按照以下步骤进行操作。

✨ 主要特性

• 视频搜索：支持通过关键词搜索 YouTube 视频。
• 信息获取：能够获取特定 YouTube 视频的详细信息，如标题、播放量等。

📦 安装指南

需求

• Python 3.10 或更高版本。
• uv（必须在运行设置之前安装）。
• YouTube 数据 API v3 密钥。您可以在Google Cloud Console获取一个。
• 兼容 bash 的 shell（主要用于 Linux/macOS 运行设置脚本）。

安装步骤

1. 克隆仓库：

git clone https://github.com/davo00019/mcp-server-youtube.git
cd mcp-server-youtube

2. 运行设置脚本：
   • 确保安装了 uv (pip install uv 或参考uv 安装)。
   • 在 mcp-server-youtube 目录内运行：

bash setup.sh

- 该脚本将执行以下操作：
    - 检查 `uv`。
    - 创建一个虚拟环境（`.venv`）在 `mcp-server-youtube` 中。
    - 安装依赖项 (`uv sync`)。
    - 提示您输入 YouTube API 密钥并创建 `.env` 文件。
    - 使服务器包装脚本可执行。
    - 打印最终说明和 MCP 主机配置所需的路径。

3. 配置 MCP 主机： - 遵循 setup.sh 脚本末尾打印的说明。 - 复制提供的“包装脚本路径”。 - 将此路径粘贴到您的 MCP 主机配置文件（例如 claude_desktop_config.json）中的 command 字段，确保 args 为空列表。

📚 详细文档

配置详细信息（.env）

setup.sh 脚本会提示您输入 YouTube 数据 API v3 密钥并创建一个 .env 文件，内容如下：

YOUTUBE_API_KEY=YOUR_API_KEY_HERE

如果需要更改密钥，请直接编辑此 .env 文件。

与 MCP 主机配合使用

• 在桌面版的 Claude 中配置服务器时，您需要修改其配置文件。具体路径请参考脚本输出。
• 将包装脚本路径正确粘贴到配置文件中，确保工具能够正常调用。

💻 使用示例

基础用法

该服务器提供多个工具来与 YouTube 交互：

• 搜索视频：通过关键词查找相关视频。
• 获取详细信息：获取特定视频的元数据，如标题、播放量等。

🤝 贡献

欢迎贡献！如果您有任何改进建议或错误修复，请随时提交问题或拉取请求。

📄 许可证

此项目在 MIT License 下许可 - 有关详细信息，请参阅 LICENSE 文件。