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