YouTube MCP Server
A Model Context Protocol (MCP) server implementation for YouTube, enabling AI language models to interact with YouTube content through a standardized interface.
Website:
接入你的智能体
发布者自己的命令。不是 PlugMCP 端点。
用我们的密钥与日志托管一份副本。
npx -y [email protected]Claude Code 没有针对本地命令的安装链接。复制下方命令并在终端中运行。
claude mcp add zubeid-youtube-mcp-server -- npx -y zubeid-youtube-mcp-server@1.0.2在终端中运行。
{ "mcpServers": { "zubeid-youtube-mcp-server": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
远程 URL 还是本机命令? 两种安装方式的区别
The server currently exposes 10 MCP tools.
videos_getVideovideoId (string): The YouTube video ID.parts (string[], optional): Specific video resource parts to retrieve.videos_searchVideosquery (string): Search query.maxResults (number, optional): Maximum number of results to return.order (string, optional): Result ordering such as relevance or date.publishedAfter (string, optional): Only include videos published after this ISO 8601 date.publishedBefore (string, optional): Only include videos published before this ISO 8601 date.channelId (string, optional): Restrict results to a specific channel.uniqueChannels (boolean, optional): Return only one video per unique channel.channelMinSubscribers / channelMaxSubscribers (number, optional): Filter matched videos by the subscriber band of their channel.channelLastUploadAfter / channelLastUploadBefore (string, optional): Filter matched videos by the latest upload activity of their channel.creatorOnly (boolean, optional): Restrict results to channels heuristically classified as creators.sortBy (string, optional): Supports relevance, subscribers_asc, subscribers_desc, indie_priority, and recent_activity.transcripts_getTranscriptvideoId (string): The YouTube video ID.language (string, optional): Transcript language code. Falls back to YOUTUBE_TRANSCRIPT_LANG or en.channels_getChannelchannelId (string): The YouTube channel ID.Responses now include:
latestVideoPublishedAtnormalizedMetadata
country, defaultLanguage, joinedAt, customUrl, emailsFound, contactLinks, and creator-vs-brand heuristic fieldschannels_getChannelschannelIds (string[]): A list of YouTube channel IDs.includeLatestUpload (boolean, optional): Whether to include latestVideoPublishedAt. Defaults to true.channels_searchChannelsquery (string): Channel search query or handle.maxResults (number, optional): Maximum number of channels to return.order (string, optional): Result ordering such as relevance.channelType (string, optional): Restrict the search to a channel type.minSubscribers / maxSubscribers (number, optional): Filter channels by subscriber band.lastUploadAfter / lastUploadBefore (string, optional): Filter channels by latest upload activity.creatorOnly (boolean, optional): Restrict results to channels heuristically classified as creators.sortBy (string, optional): Supports relevance, subscribers_asc, subscribers_desc, indie_priority, and recent_activity.channels_findCreatorsquery (string): Topic, game, or mention query to discover channels from matched videos.videoPublishedAfter / videoPublishedBefore (string, optional): Recency filters for the matched videos.channelMinSubscribers / channelMaxSubscribers (number, optional): Subscriber band filters for returned channels.channelLastUploadAfter / channelLastUploadBefore (string, optional): Latest-upload activity filters for returned channels.creatorOnly (boolean, optional): Restrict results to channels heuristically classified as creators.sortBy (string, optional): Supports relevance, subscribers_asc, subscribers_desc, indie_priority, and recent_activity.sampleVideosPerChannel (number, optional): How many matched videos to include per returned channel.channels_listVideoschannelId (string): The YouTube channel ID.maxResults (number, optional): Maximum number of videos to return.playlists_getPlaylistplaylistId (string): The YouTube playlist ID.playlists_getPlaylistItemsplaylistId (string): The YouTube playlist ID.maxResults (number, optional): Maximum number of playlist items to return.npm install -g zubeid-youtube-mcp-server
~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):{
"mcpServers": {
"zubeid-youtube-mcp-server": {
"command": "zubeid-youtube-mcp-server",
"env": {
"YOUTUBE_API_KEY": "your_primary_youtube_api_key",
"YOUTUBE_API_KEY2": "your_secondary_youtube_api_key",
"YOUTUBE_API_KEY3": "your_tertiary_youtube_api_key"
}
}
}
}
Add this to your Claude Desktop configuration:
{
"mcpServers": {
"youtube": {
"command": "npx",
"args": ["-y", "zubeid-youtube-mcp-server"],
"env": {
"YOUTUBE_API_KEY": "your_primary_youtube_api_key",
"YOUTUBE_API_KEY2": "your_secondary_youtube_api_key",
"YOUTUBE_API_KEY3": "your_tertiary_youtube_api_key"
}
}
}
}
To install YouTube MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @ZubeidHendricks/youtube --client claude
Set the following environment variables:
YOUTUBE_API_KEY: Primary YouTube Data API keyYOUTUBE_API_KEY2: Secondary fallback API keyYOUTUBE_API_KEY3: Third fallback API keyYOUTUBE_TRANSCRIPT_LANG: Default language for transcripts (optional, defaults to 'en')At least one of YOUTUBE_API_KEY, YOUTUBE_API_KEY2, or YOUTUBE_API_KEY3 must be set. When a request fails because a key has exhausted its quota, the server retries the same request with the next configured key.
For one-click installation, click one of the install buttons below:
If you prefer manual installation, first check the install buttons at the top of this section. Otherwise, follow these steps:
Add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open User Settings (JSON).
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "apiKey",
"description": "YouTube API Key",
"password": true
}
],
"servers": {
"youtube": {
"command": "npx",
"args": ["-y", "zubeid-youtube-mcp-server"],
"env": {
"YOUTUBE_API_KEY": "${input:apiKey}"
}
}
}
}
}
Optionally, you can add it to a file called .vscode/mcp.json in your workspace:
{
"inputs": [
{
"type": "promptString",
"id": "apiKey",
"description": "YouTube API Key",
"password": true
}
],
"servers": {
"youtube": {
"command": "npx",
"args": ["-y", "zubeid-youtube-mcp-server"],
"env": {
"YOUTUBE_API_KEY": "${input:apiKey}"
}
}
}
}
# Install dependencies
npm install
# Build
npm run build
# Start the server (requires at least one configured YouTube API key)
npm start
# Development mode with auto-rebuild
npm run dev
The included Docker image starts the server over HTTP by default.
httphttp://localhost:8088/mcphttp://localhost:8088/readyThe Docker build copies .env into the runtime image and the server loads it automatically on startup. That means the container can run without passing API credentials at docker run time, as long as .env was present during docker build.
docker build -t youtube-mcp-server .
docker run --rm -p 8088:8088 youtube-mcp-server
The container defaults to:
MCP_TRANSPORT=http
MCP_HOST=0.0.0.0
MCP_PORT=8088
MCP_STATELESS=true
See CONTRIBUTING.md for information about contributing to this repository.
This project is licensed under the MIT License - see the LICENSE file for details.
{ "mcpServers": { "zubeid-youtube-mcp-server": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
Zubeid Youtube 通过 stdio 在本地运行。
上次检查时间:2026-11-16。 YouTube MCP Server Implementation