{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_pafm9p3ne5d4","handle":"iflow-mcp-mourad-ghafiri-youtube-mcp-server","url":"https://wellknown.network/agents/iflow-mcp-mourad-ghafiri-youtube-mcp-server","links":{"self":"https://wellknown.network/agents/iflow-mcp-mourad-ghafiri-youtube-mcp-server/record.json","html":"https://wellknown.network/agents/iflow-mcp-mourad-ghafiri-youtube-mcp-server","markdown":"https://wellknown.network/agents/iflow-mcp-mourad-ghafiri-youtube-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-mourad-ghafiri-youtube-mcp-server","status":"https://wellknown.network/api/v1/agents/iflow-mcp-mourad-ghafiri-youtube-mcp-server/status","claim":"https://wellknown.network/agents/iflow-mcp-mourad-ghafiri-youtube-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-mourad-ghafiri-youtube-mcp-server/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-mourad-ghafiri-youtube-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-mourad-ghafiri-youtube-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-mourad-ghafiri-youtube-mcp-server/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-mourad-ghafiri-youtube-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_mourad-ghafiri-youtube-mcp-server","summary":"A YouTube MCP Server for video information and transcription","description":"# YouTube MCP Server\n\nA powerful Model Context Protocol (MCP) server for YouTube video transcription and metadata extraction. This server provides advanced tools for AI agents to retrieve video metadata and generate high-quality transcriptions with native language support.\n\n## 🌟 Features\n\n- **Metadata Extraction**: Retrieve comprehensive video details (title, description, views, duration, etc.) without downloading the video.\n- **Smart Transcription**:\n  - **In-Memory Processing**: fast, efficient, and disk-I/O free pipeline.\n  - **VAD (Voice Activity Detection)**: uses Silero VAD for precise segmentation.\n  - **Multilingual Support**: supports **99 languages**.\n  - **Translation**: Transcribe to any supported language.\n- **Caching**: Intelligent file-based caching to avoid redundant processing.\n- **Optimized Performance**:\n  - Uses `yt-dlp` for robust extraction.\n  - Hardware acceleration (MPS/CUDA) for Whisper inference.\n  - Parallel processing for transcription segments.\n\n---\n\n## 🛠️ Prerequisites\n\n- **Python 3.10+**\n- **ffmpeg**: Required for audio processing.\n  - Mac: `brew install ffmpeg`\n  - Linux: `sudo apt install ffmpeg`\n  - Windows: Download and add to PATH.\n\n## 📦 Installation\n\n1. **Clone the repository**:\n   ```bash\n   git clone https://github.com/mourad-ghafiri/youtube-mcp-server\n   cd youtube-mcp-server\n   ```\n\n2. **Install dependencies**:\n   Using `uv` (recommended):\n   ```bash\n   uv sync\n   ```\n\n## ⚙️ Configuration\n\nThe server configuration is located in `src/youtube_mcp_server/config.py`. You can adjust the following parameters:\n\n### Directories\n- **`TRANSCRIPTIONS_DIR`**: Directory where transcription JSON files are cached (default: `\"transcriptions\"`).\n\n### Models\n- **`WHISPER_MODEL_NAME`**: OpenAI Whisper model to use. Options: `\"tiny\"`, `\"base\"`, `\"small\"`, `\"medium\"`, `\"large\"`, `\"turbo\"`. (default: `\"tiny\"`).\n  > **Note**: Larger models require more RAM and a GPU (CUDA/MPS).\n- **`SILERO_REPO` / `SILERO_MODEL`**: VAD model repository and ID.\n…","publisher":null,"homepage":null,"repository":null,"version":"0.1.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_mourad-ghafiri-youtube-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"media.speech-recognition","name":"Speech Recognition","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"content.translation","name":"Translation","confidence":0.905,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"},{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":0.756,"provenance":"derived"}],"categories":["content","dev","media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_mourad-ghafiri-youtube-mcp-server","registry":"pypi","observedAt":"2026-09-15T19:23:19.611Z","publishedAt":"2026-02-08T19:20:59.053249Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_mourad-ghafiri-youtube-mcp-server","url":"https://pypi.org/project/iflow-mcp_mourad-ghafiri-youtube-mcp-server/","firstSeenAt":"2026-09-09T20:24:20.994Z","fetchedAt":"2026-09-15T19:21:56.225Z","normalizedAt":"2026-09-15T19:21:56.225Z"}]},"firstSeenAt":"2026-09-09T20:24:20.994Z","updatedAt":"2026-09-15T19:23:19.611Z"}