youtube-mcp

🚀 YouTube MCP

这是一个用于集成YouTube的模型上下文协议（MCP）服务器，可助力实现与YouTube数据和功能的交互。

🚀 快速开始

✨ 主要特性

• 作为MCP服务器，实现与YouTube的集成。
• 可与Claude Desktop集成，方便在Claude Desktop中使用。

📦 安装指南

安装uv

• Mac系统：

brew install uv

• Windows系统：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Windows系统安装完成后，需将uv添加到系统环境变量PATH中：

set Path=C:\Users\nntra\.local\bin;%Path%

💻 使用示例

与Claude Desktop集成

若要在Claude Desktop中使用此MCP服务器，需将其添加到Claude Desktop的配置中。

1. 打开Claude Desktop的配置文件：
   • Mac系统：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows系统：%APPDATA%\Claude\claude_desktop_config.json
2. 在mcpServers部分添加以下配置（将/path/to/your/youtube-mcp替换为该项目文件夹的实际路径）：

{
  "mcpServers": {
    "youtube": {
      "command": "/Users/your-username/.local/bin/uv",
      "args": ["--directory", "/path/to/your/youtube-mcp", "run", "main.py"]
    }
  },
  "globalShortcut": ""
}

⚠️ 重要提示

务必进行以下替换：

• 将/path/to/your/youtube-mcp替换为你克隆/下载该项目的实际路径。
• 将/Users/your-username/.local/bin/uv替换为你uv安装的正确路径（在Windows系统中通常为C:\Users\your-username\.local\bin\uv.exe）

3. 保存文件并重启Claude Desktop。

本地运行服务器

配置完成后，YouTube MCP服务器将在Claude Desktop中可用，你可以使用它与YouTube数据和功能进行交互。本项目使用uv进行依赖管理，依赖项在pyproject.toml中定义，锁文件为uv.lock。 若要在本地运行服务器，可执行以下命令：

uv run main.py