YouTube MCP Server

YouTube MCP 服务

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

什么是 MCP？

模型上下文协议（MCP）是由 Anthropic（Claude 的创建者）开发的一项开放标准，用于连接 AI 助手与外部数据源和工具。它让 Claude 等模型能够以标准化方式访问最新信息并在外部系统中执行操作。

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

要求

• Node.js v16 或更高版本
• YouTube API 密钥（从 Google Developer Console 获取）

安装

1. 克隆此仓库：

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

2. 安装依赖项：

npm install

3. 在项目根目录中创建 .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 密钥：

1. 前往 Google Developer Console
2. 创建一个新项目（或选择一个现有项目）
3. 在侧边栏中选择“API Library”
4. 搜索“YouTube Data API v3”并启用它
5. 在侧边栏中选择“Credentials”
6. 点击“Create credentials”，然后选择“API key”
7. 复制生成的密钥，并在 .env 文件或 Claude Desktop 配置中使用

故障排除

如果遇到错误，请检查：

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

贡献

欢迎贡献。你可以通过以下几种方式参与协作：

1. 报告错误或问题
2. 提出新功能建议
3. 提交包含改进或修复的拉取请求
4. 改进文档

联系与支持

• 在 X（Twitter）上关注我：@Nocodeboy
• 如果你觉得这个项目有用，并想表达支持：

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。