שרת ה-MCP ל-YouTube, אומת בריצה חיה על Mac אמיתי.

• כלים

  1 בלי מפתח, 8 עם מפתח [5]

• אישורי גישה

  לא נדרשים לתמלולים

• ערוץ תקשורת

  stdio, רץ על ה-Mac שלכם [4]

• מתחזק

  Kiryl Bahdanau, פרויקט קהילתי [1][3]

• הורדות

  1,128 בשבוע האחרון [2]

• רישיון

  MIT [3]

אימות

איך שרת ה-MCP הזה אומת.

השיטה

הרצנו את השרת עם npx על גבי stdio בלי YOUTUBE_API_KEY ובלי משתני סביבה משלנו, השלמנו את לחיצת היד של MCP, וקראנו ל-tools/list, שענה עם כלי אחד. אחר כך ביצענו קריאת כלי אמיתית אחת, getTranscripts על סרטון ציבורי, והיא החזירה את שורות הפתיחה והסיום של אותו סרטון בלי שום מפתח ובלי הרשמה לשום דבר. טבלת הכלים למטה היא הלכידה הזו, מילה במילה. ריצה שנייה של אותה פקודה, עם ערך דמה ב-YOUTUBE_API_KEY, הציגה שמונה כלים במקום אחד; קריאה לאחד משבעת הכלים הנוספים נכשלה מפני שהמפתח לא היה אמיתי, וטקסט השגיאה שלה נמצא בקטע פתרון התקלות. אין ברשותנו מפתח YouTube Data API, ולכן שבעת הכלים האלה מופיעים בעמוד הזה אבל מעולם לא ראינו אותם מצליחים.

YouTube MCP server (v1.1.12) running in stdio mode.

tools/call getTranscripts {"videoIds": ["dQw4w9WgXcQ"]}

{
  "dQw4w9WgXcQ": {
    "hook": "[♪♪♪] ♪ We're no strangers to love ♪ ♪ You know the rules\nand so do I ♪ ♪ A full commitment's\nwhat I'm thinking of ♪

שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.

כלים

הכלים, כפי שנספרו מהשרת הרץ.

השרת ענה ל-tools/list עם 1 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.

פרמטרים המסומנים ב-* הם חובה.

התקנה

הגדרות שעובדות, אחת לכל אפליקציה.

העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": [
        "-y",
        "@kirbah/mcp-youtube"
      ]
    }
  }
}

claude mcp add youtube -- npx -y @kirbah/mcp-youtube

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": [
        "-y",
        "@kirbah/mcp-youtube"
      ]
    }
  }
}

Name        YouTube
Command     npx
Arguments   -y @kirbah/mcp-youtube

בלי טרמינל

איך מגדירים את שרת ה-MCP‏ YouTube בלי טרמינל.

אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים שלושה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות.

1. 01

   התקינו את Routines

   הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.

2. 02

   פתחו את הגדרות ה-MCP

   לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.

3. 03

   בחרו Command (stdio)‎

   העבירו את הטופס ל-Command (stdio). השרת הזה הוא פקודה שה-Mac שלכם מריץ, לא כתובת אינטרנט, ולכן האפשרות השנייה לא תעבוד עבורו.

4. 04

   מלאו שלושה שדות

   Name: YouTube. Command: npx. Arguments: ‎-y @kirbah/mcp-youtube. זו כל ההגדרה, והיא זו שאימתנו. אין למה להירשם ואין מה להדביק.

5. 05

   בדקו, ואז הוסיפו

   השאירו את Environment Variables ריק ולחצו Test Connection: Routines מפעילה את השרת ומדווחת כמה כלים היא מצאה, אחד עבור ההגדרה הזו. אם תרצו את שבעת הנוספים, הוסיפו YOUTUBE_API_KEY עם מפתח מ-Google Cloud Console ובדקו שוב, והמספר יהפוך לשמונה. אחר כך לחצו Add Server.

6. 06

   השתמשו בו

   הכלים עובדים בצ׳אט מיד: הדביקו קישור YouTube ושאלו מה נאמר בסרטון. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.

רעיונות לשגרות

שגרות ששווה לתזמן.

אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.

פתרון תקלות

השגיאות שנתקלנו בהן, ומה פתר אותן.

שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.

[TranscriptService] Failed to fetch transcript for xxxxxxxxxxx (lang: en): No transcripts are available for the video with ID "xxxxxxxxxxx". This may be because the video does not have captions or the captions are not accessible.

[TranscriptService] Failed to fetch transcript for dQw4w9WgXcQ (lang: zz): No transcripts are available in "zz" for the video with ID "dQw4w9WgXcQ". Available languages: en, en, de-DE, ja, pt-BR, es-419. Please try a different language.

MCP error -32602: Tool getVideoDetails not found

Error: YouTube API call for getVideo failed for videoId: dQw4w9WgXcQ

שאלות נפוצות

שאלות שאנשים שואלים.

מקורות

כל טענה חיצונית, עם קבלה.

כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.

1. [1]

   npm registry: @kirbah/mcp-youtubeנקרא בתאריך 2026-08-03

   Latest version 1.1.12, published 2026-07-27; author Kiryl Bahdanau, MIT licensed, Node 20.12 or newer.

2. [2]

   npm downloads API: last weekנקרא בתאריך 2026-08-03

   1,128 downloads for the week ending 2026-08-01, and 3,120 for the month.

3. [3]

   GitHub API: kirbah/mcp-youtubeנקרא בתאריך 2026-08-03

   25 stars, 14 forks, MIT license, not archived, and a push dated 2026-08-01 at access time.

4. [4]

   kirbah/mcp-youtube READMEנקרא בתאריך 2026-08-03

   The Zero-Config Mode section, the env block for the key, the Google Cloud Console steps, and the per-tool quota costs.

5. [5]

   kirbah/mcp-youtube source: src/tools/index.tsנקרא בתאריך 2026-08-03

   registerTools checks YOUTUBE_API_KEY and registers eight tools when it is set, getTranscripts alone when it is not.

6. [6]

   kirbah/mcp-youtube source: src/services/transcript.service.tsנקרא בתאריך 2026-08-03

   Transcripts come from the youtube-transcript-plus package, with no API key anywhere in that path.

7. [7]

   kirbah/mcp-youtube source: src/utils/env.tsנקרא בתאריך 2026-08-03

   loadEnv() resolves .env against the working directory and calls process.loadEnvFile when that file exists; index.ts and container.ts both call it at startup, which is also why the package asks for Node 20.12 or newer.

8. [8]

   Google: YouTube Data API v3, getting startedנקרא בתאריך 2026-08-03

   How to obtain an API key, and the default daily quota of 100 search.list calls plus 10,000 units for all other endpoints.

9. [9]

   Model Context Protocol registry: YouTube serversנקרא בתאריך 2026-08-03

   Every YouTube server listed is a community package; none is published by Google.

10. [10]

    modelcontextprotocol.io: Connect to local MCP serversנקרא בתאריך 2026-08-03

    The official Claude Desktop quickstart and the location of its config file.

11. [11]

    Claude Code docs: MCPנקרא בתאריך 2026-08-03

    The claude mcp add syntax for local stdio servers, including the --env flag.

12. [12]

    Cursor docs: Model Context Protocolנקרא בתאריך 2026-08-03

    The mcp.json shape and file locations.

13. [13]

    Routines: Connectorsנקרא בתאריך 2026-08-03

    How Routines runs one-click OAuth connectors and any MCP server.

העמוד הזה מתאר את YouTube כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.