Serveur MCP YouTube Transcript
Commit 4 nov. 2026Extrayez les transcriptions YouTube avec horodatage, gérez l'historique et récupérez les statistiques des vidéos pour les assistants IA.
Aussi connu sous Youtube-Transcript-Dev/youtube-transcript-mcp, youtube-transcript-mcp
- Étoiles
- 0
- Outils
- 17
- Téléchargements, 30 jours
- —
- Dernière version
- 2.0.0
- Dernier commit
- 4 nov. 2026
- Licence
- MIT
Qu'est-ce que YouTube Transcript MCP ?
Extrayez les transcriptions YouTube avec horodatage, gérez l'historique et récupérez les statistiques des vidéos pour les assistants IA. Il expose 17 outils, comme get_stats, transcribe_v2, list_transcripts.
Résumé généré à partir du README du projet
À propos du MCP server YouTube Transcript
Ce serveur permet aux assistants IA d'extraire des transcriptions YouTube avec horodatage et de gérer l'historique du contenu vidéo. Il permet aux utilisateurs de connecter des outils tels que Claude, Cursor, Windsurf et VS Code à YouTubeTranscript.dev pour traiter les données vidéo sans écrire de code personnalisé. Le serveur fournit des outils spécifiques pour récupérer les sous-titres, effectuer des recherches dans les transcriptions précédentes et obtenir les statistiques des vidéos.
Les utilisateurs peuvent interagir avec le service via une URL MCP distante ou en l'exécutant localement avec npm. Les méthodes de connexion incluent OAuth pour les clients compatibles ou la fourniture d'une clé API via les en-têtes d'autorisation. La boîte à outils comprend transcribe_v2 pour une extraction rapide des sous-titres, list_transcripts pour la gestion de l'historique avec pagination, et get_stats pour surveiller les crédits et les limites de débit. Il prend en charge les sous-titres manuels et automatiques pour garantir une récupération flexible des données.
Ce que vous pouvez faire avec
- 1Extraire les sous-titres de vidéosUn assistant IA peut extraire le texte d'une URL YouTube en incluant un formatage spécifique comme des horodatages ou des paragraphes.
- 2Gérer l'historique des transcriptionsLes développeurs peuvent effectuer des recherches dans leurs transcriptions précédemment extraites en utilisant des ID de vidéo ou du texte spécifique.
- 3Surveiller l'utilisation de l'APIVous pouvez vérifier vos crédits restants et votre plan d'abonnement actuel directement via l'assistant.
- 4Nettoyer les données stockéesUne IA peut supprimer des enregistrements de transcription spécifiques ou l'ensemble des transcriptions associées à un ID de vidéo particulier.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer YouTube Transcript MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller YouTube Transcript MCP dans Claude Code
$ claude mcp add --transport http youtube-transcript-mcp https://mcp.youtubetranscript.dev/Installer YouTube Transcript MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"youtube-transcript-mcp": {
"url": "https://mcp.youtubetranscript.dev/"
}
}
}Installer YouTube Transcript MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"youtube-transcript-mcp": {
"type": "http",
"url": "https://mcp.youtubetranscript.dev/"
}
}
}Installer YouTube Transcript MCP dans VS Code CLI
$ code --add-mcp '{"name":"youtube-transcript-mcp","type":"http","url":"https://mcp.youtubetranscript.dev/"}'Installer YouTube Transcript MCP dans Codex
$ codex mcp add youtube-transcript-mcp --url https://mcp.youtubetranscript.dev/Installer YouTube Transcript MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.youtube-transcript-mcp] url = "https://mcp.youtubetranscript.dev/"
Installer YouTube Transcript MCP dans Gemini CLI
$ gemini mcp add -s user --transport http youtube-transcript-mcp https://mcp.youtubetranscript.dev/Installer YouTube Transcript MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"youtube-transcript-mcp": {
"url": "https://mcp.youtubetranscript.dev/",
"type": "http"
}
}
}Outils MCP YouTube Transcript 17
Détectés depuis le READMEget_statstranscribe_v2list_transcriptsget_transcriptdelete_transcriptvideolanguagesourceformatsearchlimitpage
| get_stats | — | |
| transcribe_v2 | — | |
| list_transcripts | — | |
| get_transcript | — | |
| delete_transcript | — | |
| video | — | |
| language | — | |
| source | — | |
| format | — | |
| search | — | |
| limit | — | |
| page | — |
Afficher les 17 outilsAfficher moins d'outils
statusinclude_segmentsvideo_idinclude_timestampsids
| status | — | |
| include_segments | — | |
| video_id | — | |
| include_timestamps | — | |
| ids | — |
Configuration
YTSM_API_KEY
| Nom | Description | Type |
|---|---|---|
| YTSM_API_KEY | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibleyoutube-transcript-dev/youtube-transcript-mcp is public and reachablegithub.com/youtube-transcript-dev/youtube-transcript-mcp ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-04github.com/youtube-transcript-dev/youtube-transcript-mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPHTTPS endpoint answered 401 (sign-in required)Réussi
README
Voir sur GitHubWhy This MCP Server?
Connect Claude, Cursor, Windsurf, or any MCP client to YouTubeTranscript.dev — no custom code. Your AI assistant gets tools to extract transcripts, list history, and manage content at scale.
- ⚡ Fast caption extraction — Manual or auto captions, returns in seconds
- 📚 Transcript history — List, search, and paginate your transcripts
- 🎯 Full control — Get stats, delete transcripts, fetch by video ID
- 🔌 One config — Works with Claude, Cursor, Windsurf, VS Code, Cline
- 🔒 User-owned keys — API key per connection, no server-side secrets
Quick Start
Remote MCP URL: https://mcp.youtubetranscript.dev
Claude, Cursor, and VS Code can add this as a remote MCP connector. ChatGPT users must enable Developer mode and create a custom app with this URL; availability depends on the workspace plan. OAuth-capable clients sign in once, so no API key is needed in the chat.
| Client | One-click |
|---|---|
| Claude | Add custom connector |
| ChatGPT | Developer mode / custom MCP app setup or Custom GPT |
| Cursor | Install |
| VS Code | Install |
| Claude Code | claude mcp add --transport http youtubetranscript https://mcp.youtubetranscript.dev |
| Grok | grok mcp add --transport http youtubetranscript https://mcp.youtubetranscript.dev |
Full walkthrough: youtubetranscript.dev/resources/mcp-server
API key clients (if the tool has no OAuth): send Authorization: Bearer YOUR_API_KEY. x-api-token still works. Get a key from the account page.
Run locally (optional): npm install && npm run build && npm run start:http — then connect to http://localhost:8080.
MCP Connection Settings
Claude Code
claude mcp add --transport http youtubetranscript https://mcp.youtubetranscript.dev
Claude Desktop
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"youtubetranscript": {
"url": "https://mcp.youtubetranscript.dev",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Cursor
.cursor/mcp.json:
{
"mcpServers": {
"youtubetranscript": {
"url": "https://mcp.youtubetranscript.dev",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Windsurf
~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"youtubetranscript": {
"serverUrl": "https://mcp.youtubetranscript.dev",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
VS Code + Copilot
settings.json:
{
"mcp": {
"servers": {
"youtubetranscript": {
"url": "https://mcp.youtubetranscript.dev",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
}
Cline
Add to your Cline MCP config (format may vary by Cline version):
{
"youtubetranscript": {
"url": "https://mcp.youtubetranscript.dev",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
Replace YOUR_API_KEY with your API key from youtubetranscript.dev/dashboard/account.
Configuration
Server Environment (for deployment)
| Variable | Description | Default |
|---|---|---|
YTSM_BASE_URL |
Base URL of the API | https://www.youtubetranscript.dev |
MCP_PUBLIC_URL |
Public MCP origin | https://mcp.youtubetranscript.dev |
YTSM_TIMEOUT_MS |
Request timeout in ms | 30000 |
PORT |
HTTP server port | 8080 |
DEBUG |
Enable debug logging | false (set true to enable) |
Note: HTTP mode uses OAuth where the client supports it, including compatible Claude, Cursor, VS Code, and Grok clients. ChatGPT requires Developer mode and a custom MCP app. API-key clients can send Authorization: Bearer / x-api-token from the client. Do not put user keys in server env. For stdio mode, set YTSM_API_KEY. Always set YTSM_BASE_URL to https://www.youtubetranscript.dev — the apex host 301s and breaks POST/auth.
Tools Reference
| Tool | Best for | Returns |
|---|---|---|
get_stats |
Credits, transcripts count, plan | credits, transcripts_total, plan, rate_limit |
transcribe_v2 |
Create/fetch transcript (fast) | Transcript JSON |
list_transcripts |
List user transcripts | History list with pagination |
get_transcript |
Get full transcript by video_id | Transcript detail |
delete_transcript |
Delete transcript(s) | Delete result |
get_stats
Credits left, transcripts created, plan, rate limit. No parameters.
transcribe_v2
Fast caption-based transcript (no ASR). Uses manual or auto captions only.
| Parameter | Required | Description |
|---|---|---|
video |
Yes | YouTube URL or 11-character video ID |
language |
No | Language tag (e.g. en, en-US) |
source |
No | auto (default) or manual |
format |
No | { timestamp, paragraphs, words } booleans |
list_transcripts
List transcript history for the authenticated user.
| Parameter | Required | Description |
|---|---|---|
search |
No | Search by video id, title, or transcript text |
limit |
No | How many to return (default 10) |
page |
No | Page number (default 1) |
status |
No | all, queued, processing, succeeded, failed |
language |
No | Language filter (e.g. en) |
include_segments |
No | Include transcript segments in response |
get_transcript
Get full transcript by video_id.
| Parameter | Required | Description |
|---|---|---|
video_id |
Yes | YouTube video ID |
id |
No | Transcript record id for specific version |
language |
No | Language filter |
source |
No | auto, manual, or asr |
include_timestamps |
No | Include timestamps in response |
delete_transcript
Delete transcript records.
| Parameter | Required | Description |
|---|---|---|
ids |
No* | Array of transcript record ids to delete |
video_id |
No* | Convenience: delete by video id (resolves id) |
*Provide at least one of ids or video_id.
Deployment (Optional)
For production, deploy to a service that supports long-lived connections (e.g. Cloud Run, Railway, Fly.io). Avoid serverless (Vercel, Lambda) for MCP — timeouts and concurrency limits cause issues.
docker build -f Dockerfile.cloudrun -t gcr.io/YOUR_PROJECT/youtube-transcript-mcp .
docker push gcr.io/YOUR_PROJECT/youtube-transcript-mcp
gcloud run deploy youtube-transcript-mcp --image gcr.io/YOUR_PROJECT/youtube-transcript-mcp ...
Stdio (Alternative)
Run as a subprocess instead of HTTP. Required: set YTSM_API_KEY in env (API key is not passed per-request for stdio).
{
"mcpServers": {
"youtubetranscript": {
"command": "node",
"args": ["dist/index.js"],
"env": { "YTSM_API_KEY": "YOUR_API_KEY" }
}
}
}
Run from the project directory after npm run build. For globally installed package, use the path to dist/index.js in the package.
Development
npm install
npm run build
npm test
npm run start:http # Local HTTP server (port 8080)
Quick test all tools (requires YTSM_API_KEY in env):
npm install && npm run build
export YTSM_API_KEY=your_key # bash/mac
$env:YTSM_API_KEY="your_key" # PowerShell
npm run test:all
See QUICK_TEST.md for full testing instructions.
Links
License
MIT License — see LICENSE for details.
Questions sur YouTube Transcript MCP
Comment ajouter YouTube Transcript MCP à Claude Code ?
Exécutez claude mcp add --transport http youtube-transcript-mcp https://mcp.youtubetranscript.dev/ dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter YouTube Transcript MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils YouTube Transcript MCP fournit-il ?
Il expose 17 outils, dont get_stats, transcribe_v2, list_transcripts, get_transcript, delete_transcript.
Comment puis-je ajouter cela à Claude ?
Vous pouvez l'ajouter en tant que connecteur MCP distant via l'URL fournie ou en ajoutant la configuration du serveur à votre fichier claude_desktop_config.json.
Quel type de transcriptions puis-je extraire ?
Le serveur prend en charge l'extraction rapide basée sur les sous-titres, qu'ils soient manuels ou automatiques.
Ai-je besoin d'une clé API ?
Oui, vous pouvez obtenir une clé API gratuite sur le site YouTubeTranscript.dev pour l'utiliser avec le serveur.
Puis-je effectuer des recherches dans mes transcriptions précédentes ?
Oui, l'outil list_transcripts vous permet de rechercher dans votre historique par ID de vidéo, titre ou texte de transcription.