Youtubemcp

🚀 YouTube MCP 服务器

YouTube MCP 服务器是一个模型上下文协议（MCP）服务器，它允许 AI 代理通过自然语言命令搜索和播放 YouTube 视频。

✨ 主要特性

• searchVideos：在 YouTube 上搜索与任何查询匹配的视频。
• playPlaylist：在默认浏览器中以播放列表的形式打开视频。

📦 安装指南

前提条件

1. 安装 Node.js 18+。
2. 从 Google Cloud Console 获取 YouTube Data API v3 密钥。

获取 YouTube API 密钥

1. 访问 Google Cloud Console。
2. 创建一个新项目（或选择现有项目）。
3. 导航到 APIs & Services > Library。
4. 搜索 “YouTube Data API v3” 并启用它。
5. 转到 APIs & Services > Credentials。
6. 点击 Create Credentials > API Key。
7. 复制你的 API 密钥。

安装步骤

1. 克隆仓库。
2. 安装依赖项：

   npm install
   

3. 配置环境变量： 在根目录下创建一个 .env 文件（从 .env.example 复制）：

   cp .env.example .env
   

   编辑 .env 文件并添加你的 YOUTUBE_API_KEY。
4. 构建项目：

   npm run build
   

将以下内容添加到你的 MCP 配置中（例如，.cursor/mcp.json 或 Claude Desktop 配置）：

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "node",
      "args": ["/path/to/your/project/youtubeMCP/dist/index.js"]
    }
  }
}

⚠️ 重要提示

服务器将自动从项目目录中的 .env 文件加载 YOUTUBE_API_KEY。或者，你也可以直接在上述 JSON 配置的 env 对象中传递它。

💻 使用示例

配置完成后，你可以向你的 AI 代理提出以下请求：

• “在 YouTube 上搜索 10 首最佳英文歌曲”
• “播放 5 个放松的钢琴音乐视频”
• “查找泰勒·斯威夫特的歌曲并播放”
• “搜索编码教程”

可用工具

searchVideos

通过查询在 YouTube 上搜索视频。 参数：

• query（字符串，必需）：搜索查询。
• maxResults（数字，可选）：结果数量（1 - 50，默认值：10）。

playPlaylist

在浏览器中播放视频。 参数：

• videoIds（字符串数组，可选）：要播放的视频 ID 数组。
• query（字符串，可选）：搜索并播放与此查询匹配的视频。
• maxResults（数字，可选）：使用查询时的视频数量（默认值：10）。

🔧 技术细节

开发命令

# 开发模式下的监听模式
npm run dev

# 构建
npm run build

# 启动
npm start

项目结构

YouTubeMCP/
├── package.json
├── tsconfig.json
├── README.md
├── src/
│   ├── index.ts           # MCP 服务器入口点
│   ├── youtube-client.ts  # YouTube API 包装器
│   └── tools/
│       ├── search.ts      # searchVideos 工具
│       └── play.ts        # playPlaylist 工具
└── dist/                  # 编译后的 JavaScript

📄 许可证

本项目采用 MIT 许可证。