YouTube MCP服务器

一个基于模型上下文协议(MCP)的服务器,允许AI助手(如Claude)通过标准化方式与YouTube API交互,实现视频搜索、频道查询等功能。

  • by Nocodeboy
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Nocodeboy/youtube-mcp-server

使用说明

YouTube MCP服务器

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

什么是MCP?

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

MCP作为人工智能的“通用桥梁”,为模型访问各种内容存储库、业务服务或应用程序提供了一种标准化的方式。

需求

  • Node.js v16或更高版本
  • YouTube API密钥(从Google开发者控制台获得)

安装

  1. 克隆此存储库:
git clone https://github.com/Nocodeboy/youtube-mcp-server.git
cd youtube-mcp-server
  1. 安装依赖项:
npm install
  1. 创建一个 .env 文件,并添加您的YouTube API密钥:
YOUTUBE_API_KEY=your_api_key_here

执行

要启动服务器,请运行:

npm start

与Claude Desktop集成

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

{
  "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 (string,可选):获取下一页结果的令牌

2.获取视频详细信息

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

get_video_details

参数:

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

3.获取频道详细信息

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

get_channel_details

参数:

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

4.搜索频道

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

search_channels

参数:

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

可用资源

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

使用示例

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

  • “搜索Python编程视频”
  • “显示ID为dQw4w9WgXcQ的视频详细信息”
  • “搜索烹饪相关频道”
  • “给我提供有关GoogleDevelopers频道的信息”
  • “现在最受欢迎的视频是什么?”

获取YouTube API密钥

获取YouTube API密钥:

  1. 转到 谷歌开发者控制台
  2. 创建新项目(或选择现有项目)
  3. 在侧栏中,选择“API库”
  4. 搜索“YouTube数据API v3”并启用它
  5. 在侧栏中,选择“凭据”
  6. 单击“创建凭据”并选择“API密钥”
  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(推特)上关注我: @夜猫子
  • 如果您认为此项目有用并希望表示支持:

许可证

该项目根据MIT许可证获得许可。有关更多详细信息,请参阅LICENSE文件。