JinDaGe - youtubemcp MCP Details

article

README

🚀 YouTube MCP 服务器

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

✨ 主要特性

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

📦 安装指南

前提条件

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

获取 YouTube API 密钥

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

安装步骤

克隆仓库。
安装依赖项：
```
npm install
```
配置环境变量：在根目录下创建一个 .env 文件（从 .env.example 复制）：
```
cp .env.example .env
```
编辑 .env 文件并添加你的 YOUTUBE_API_KEY。
构建项目：
```
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 许可证。

youtubemcp