YouTube-MCP

使用Java MCP SDK和Spring AI构建的用于YouTube搜索、字幕提取等的MCP（模型上下文协议）服务器。仅在字幕提取时使用了JavaScript。

此项目已通过MCP Review认证：youtube-mcp-server

提供的工具

• youtube_search: 使用查询字符串在YouTube上搜索视频。
• youtube_transcript: 根据视频ID获取YouTube视频的字幕。
• youtube_video_details: 根据视频ID获取YouTube视频的详细信息。
• youtube_video_thumbnails: 根据视频ID获取YouTube视频的缩略图URL。
• youtube_video_comments: 列出根据视频ID的YouTube视频的评论。（仅限公开评论）
• youtube_channel_info: 根据频道ID获取YouTube频道的信息。
• youtube_channel_playlists: 列出根据频道ID的YouTube频道的播放列表。
• youtube_channel_sections: 列出根据频道ID的YouTube频道的部分（货架）。
• youtube_playlist_items: 列出根据播放列表ID的YouTube播放列表中的视频。
• youtube_activities: 列出根据频道ID的YouTube频道的活动。（仅限公开活动）
• youtube_video_categories: 列出一个地区可用的视频类别。

视频

https://youtu.be/glXZ-T38hJg

博客

YouTube-MCP: 一款用于YouTube的模型上下文协议服务器

运行MCP服务器并从MCP主机连接到它

作为Docker容器运行MCP服务器

Docker镜像可以在Docker Hub上找到 - https://hub.docker.com/r/codewizard01/youtube-mcp

先决条件

• Docker

docker run -e YOUTUBE_API_KEY=<你的API密钥> -p 8085:8080 codewizard01/youtube-mcp:latest

这将在端口8085启动MCP服务器。

然后，在您的mcp配置文件中添加以下内容以通过SSE进行交互：

{
  "youtube": {
    "mcp_server": "http://localhost:8085"
  }
}

从IDE运行MCP服务器

先决条件

• Java 24
• Maven 3.8.1
• Node

1. 克隆仓库
2. 在您的IDE中打开项目
3. 运行以下命令构建项目

mvn clean install
npm install

4. 运行以下命令启动服务器

mvn spring-boot:run

5. 默认情况下，服务器将在端口8080启动。您可以在application.properties文件中更改端口。

通过标准输入输出与MCP服务器交互

在application.properties文件中启用以下注释属性以启用标准输入输出。

# 对于使用stdio集成，请启用以下设置
#spring.ai.mcp.server.stdio=true
#spring.main.banner-mode=off
#spring.main.web-application-type=none
#logging.pattern.console=
#logging.file.name=youtube-mcp-spring.log

运行mvn package以构建jar文件。jar文件将创建在目标目录下。

现在，在任何MCP主机（如Claude桌面或Github Copilot）的MCP配置文件中添加以下内容以通过stdio进行交互：

  "youtube-mcp": {
    "command": "java",
    "args": [
      "-jar", 
      "/Users/codewiz/youtube-mcp/target/youtube-m-0.0.1-SNAPSHOT.jar"
    ],
    "env": {
      "YOUTUBE_API_KEY": "<你的API密钥>"
    }
  }