YouTube Transcript Server

YouTube videolarından transcript almayı sağlayan bir Model Context Protocol sunucusu. Bu sunucu, basit bir arayüz aracılığıyla video altyazılarına ve subtitle'lara doğrudan erişim imkanı sağlar.

Smithery üzerinden Kurulum

YouTube Transcript Server'ı Claude Desktop'ta otomatik olarak Smithery aracılığıyla kurmak için:

npx -y @smithery/cli install @kimtaeyoon83/mcp-server-youtube-transcript --client claude

Bileşenler

Tools

• get_transcript
  • YouTube videolarından transcript'i çıkar
  • Girdiler:
    • url (string, gerekli): YouTube video URL'si, Shorts URL'si veya video ID'si
    • lang (string, isteğe bağlı, varsayılan: "en"): Transcript için dil kodu (örneğin, 'ko', 'en'). İstenen dil bulunamazsa otomatik olarak mevcut dillere geri döner.
    • include_timestamps (boolean, isteğe bağlı, varsayılan: false): Çıktıya zaman damgalarını dahil et (örneğin, '[0:05] metin')
    • strip_ads (boolean, isteğe bağlı, varsayılan: true): Bölüm işaretlerine dayanarak transcript'ten sponsorlukları, reklamları ve tanıtım içeriğini filtrele

Temel Özellikler

• Birden fazla video URL formatı desteği (YouTube Shorts dahil)
• Otomatik yedek özelliğine sahip dile özgü transcript alma
• Belirli anları referans vermek için isteğe bağlı zaman damgaları
• Yerleşik reklam/sponsorluk filtreleme (varsayılan olarak etkin)
• Transcript alma için harici bağımlılık yok
• Yanıtlarda ayrıntılı metadata

Yapılandırma

Claude Desktop ile kullanmak için bu sunucu yapılandırmasını ekleyin:

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

Tool aracılığıyla Kurulum

mcp-get Model Context Protocol (MCP) sunucularını kurmanın ve yönetmenin bir komut satırı aracı.

npx @michaellatman/mcp-get@latest install @kimtaeyoon83/mcp-server-youtube-transcript

Awesome-mcp-servers

awesome-mcp-servers Model Context Protocol (MCP) sunucularının kuratörlü bir listesi.

Geliştirme

Gereksinimler

• Node.js 18 veya üstü
• npm veya yarn

Kurulum

Bağımlılıkları yükleyin:

npm install

Sunucuyu derleyin:

npm run build

Otomatik yeniden derleme ile geliştirme için:

npm run watch

Test Etme

npm test

Hata Ayıklama

MCP sunucuları stdio üzerinden iletişim kurduğundan, hata ayıklama zorlu olabilir. Geliştirme için MCP Inspector'ı kullanmanızı öneririz:

npm run inspector

Evals Çalıştırma

Evals paketi, index.ts dosyasını çalıştıran bir mcp client'ı yükler, bu nedenle testler arasında yeniden derlemeye gerek yoktur. Ortam değişkenlerini npx komutunun başına ekleyerek yükleyebilirsiniz. Tam belgelere buradan ulaşabilirsiniz.

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

Hata Yönetimi

Sunucu, yaygın senaryolar için güçlü hata yönetimi uygular:

• Geçersiz video URL'leri veya ID'leri
• Kullanılamayan transcript'ler
• Dil kullanılabilirliği sorunları
• Ağ hataları

Kullanım Örnekleri

1. Video URL'si ile transcript al:

await server.callTool("get_transcript", {
  url: "https://www.youtube.com/watch?v=VIDEO_ID",
  lang: "en"
});

2. Video ID'si ile transcript al:

await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  lang: "ko"
});

3. YouTube Shorts'tan transcript al:

await server.callTool("get_transcript", {
  url: "https://www.youtube.com/shorts/VIDEO_ID"
});

4. Zaman damgaları ile transcript al:

await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  include_timestamps: true
});

5. Reklam filtrelemesi olmadan ham transcript al:

await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  strip_ads: false
});

6. Claude Desktop Uygulamasında YouTube Altyazılarını Çıkarma

chat: https://youtu.be/ODaHJzOyVCQ?si=aXkJgso96Deri0aB Extract subtitles

Güvenlik Değerlendirmeleri

Sunucu:

• Tüm giriş parametrelerini doğrular
• YouTube API hatalarını incelikle yönetir
• Transcript alma için zaman aşımı uygular
• Sorun giderme için ayrıntılı hata mesajları sağlar

Lisans

Bu MCP sunucusu MIT Lisansı altında lisanslanmıştır. Ayrıntılar için LICENSE dosyasına bakınız.