MCP 服务器

YouTube MCP Server

一个 MCP 服务器，允许 Claude 和其他 AI 助手与 YouTube API 交互，提供搜索视频/频道以及检索关于它们的详细信息的工具。

README

YouTube MCP 服务器

这是一个 MCP (模型上下文协议) 服务器，允许 Claude 和其他 AI 助手与 YouTube API 交互。该服务器提供搜索视频、获取特定视频的详细信息、搜索频道以及获取频道详细信息等工具。

什么是 MCP？

模型上下文协议 (MCP) 是由 Anthropic (Claude 的创建者) 开发的开放标准，用于将 AI 助手与外部数据源和工具连接起来。它允许像 Claude 这样的模型以标准化的方式访问最新的信息并在外部系统中执行操作。

MCP 充当 AI 的“通用桥梁”，为模型提供了一种标准化的方式来访问各种内容存储库、业务服务或应用程序。

要求

Node.js v16 或更高版本
一个 YouTube API 密钥 (从 Google Developer Console 获取)

安装

克隆此存储库:

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

安装依赖项:

npm install

在项目根目录中创建一个 .env 文件，并添加您的 YouTube API 密钥:

YOUTUBE_API_KEY=your_api_key_here

执行

要启动服务器，请运行:

npm start

与 Claude Desktop 集成

要将此 MCP 服务器与 Claude Desktop 一起使用，请将以下配置添加到您的 claude_desktop_config.json 文件中 (通常位于 Windows 上的 %APPDATA%\Claude\ 或 macOS 上的 ~/Library/Application Support/Claude/):

{
  "mcpServers": {
    "youtube": {
      "command": "node",
      "args": ["path/to/youtube-mcp-server/index.js"],
      "env": {
        "YOUTUBE_API_KEY": "your_api_key_here"
      }
    }
  }
}

将 "path/to/youtube-mcp-server/index.js" 替换为 index.js 文件的绝对路径，并将 "your_api_key_here" 替换为您的 YouTube API 密钥。

可用工具

1. 搜索视频

根据查询在 YouTube 上搜索视频。

search_videos

参数:

query (字符串, 必需): 搜索词
maxResults (数字, 可选): 最大结果数 (介于 1 和 50 之间)
pageToken (字符串, 可选): 获取下一页结果的令牌

2. 获取视频详情

获取有关特定视频的详细信息。

get_video_details

参数:

videoId (字符串, 必需): YouTube 视频 ID

3. 获取频道详情

获取有关特定频道的详细信息。

get_channel_details

参数:

channelId (字符串, 必需): YouTube 频道 ID

4. 搜索频道

根据查询在 YouTube 上搜索频道。

search_channels

参数:

query (字符串, 必需): 搜索词
maxResults (数字, 可选): 最大结果数 (介于 1 和 50 之间)
pageToken (字符串, 可选): 获取下一页结果的令牌

可用资源

youtube://popular/videos: YouTube 上当前流行的视频列表

使用示例

使用 Claude Desktop，您可以提出如下问题:

"搜索 Python 编程视频"
"显示 ID 为 dQw4w9WgXcQ 的视频的详细信息"
"搜索与烹饪相关的频道"
"给我关于 GoogleDevelopers 频道的信息"
"现在最流行的视频是什么？"

获取 YouTube API 密钥

要获取 YouTube API 密钥:

转到 Google Developer Console
创建一个新项目 (或选择一个现有项目)
在侧边栏中，选择 "API 库"
搜索 "YouTube Data API v3" 并启用它
在侧边栏中，选择 "凭据"
单击 "创建凭据" 并选择 "API 密钥"
复制生成的密钥并在您的 .env 文件或 Claude Desktop 配置中使用它

故障排除

如果遇到错误，请检查:

您是否已使用 npm install 安装所有依赖项
您的 YouTube API 密钥是否有效
您是否已在您的 Google 项目中启用 YouTube Data API v3
您是否正在使用 Node.js 16 或更高版本
如果您使用 Claude Desktop，请检查 %APPDATA%\Claude\logs\ (Windows) 或 ~/Library/Logs/Claude/ (macOS) 中的日志