{"_id":"@gabriel3615/mcp-youtube-transcript","_rev":"6-92cedcdfe2b2621ca1ca87530c1e1dce","name":"@gabriel3615/mcp-youtube-transcript","dist-tags":{"latest":"0.2.0"},"versions":{"0.0.13":{"name":"@gabriel3615/mcp-youtube-transcript","version":"0.0.13","keywords":["mcp","youtube","transcript","subtitles","captions","video","ai","claude","cursor","cline","modelcontextprotocol"],"author":{"name":"sinco"},"license":"MIT","_id":"@gabriel3615/mcp-youtube-transcript@0.0.13","maintainers":[{"name":"gabriel3615","email":"gabriel.liu3615@gmail.com"}],"homepage":"https://github.com/sinco-lab/mcp-youtube-transcript","bugs":{"url":"https://github.com/sinco-lab/mcp-youtube-transcript/issues"},"bin":{"youtube-transcript":"dist/cli.js","mcp-youtube-transcript":"dist/index.js"},"dist":{"shasum":"44b3082b34a434d0a080d2a99d8608a0ef0cb86c","tarball":"https://registry.npmjs.org/@gabriel3615/mcp-youtube-transcript/-/mcp-youtube-transcript-0.0.13.tgz","fileCount":6,"integrity":"sha512-KoQ43bEMlWHTiHeJsqn2ph5Y4RxSaEthRUxZSJPRdkU+4mYNVdQdK1GrmfDrWCKRinLb899uScNFgZ3bypbN6A==","signatures":[{"sig":"MEYCIQDkeIomHH87OmW/U8BGjoGLBGjZUKPLWnr7QSc3TmcI2gIhALv34nzymL5sFT4AGrj0DPF8tv4wEjWm2ndrcL80ravr","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29812},"main":"dist/index.js","type":"module","module":"dist/index.js","engines":{"node":">=18.0.0"},"gitHead":"34bf667062bee99753af0a21e036db274bd33674","scripts":{"cli":"pnpm build && node dist/cli.js","test":"vitest run","build":"tsc","clean":"rimraf dist","test:ui":"vitest --ui","test:watch":"vitest","release:major":"npm version major && npm publish --access public","release:minor":"npm version minor && npm publish --access public","release:patch":"npm version patch && npm publish --access public","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"gabriel3615","actor":{"name":"gabriel3615","type":"user","email":"gabriel.liu3615@gmail.com"},"email":"gabriel.liu3615@gmail.com"},"repository":{"url":"git+https://github.com/sinco-lab/mcp-youtube-transcript.git","type":"git"},"_npmVersion":"10.9.2","description":"A server built on the Model Context Protocol (MCP) that enables direct downloading of YouTube video transcripts, supporting AI and video analysis workflows.","directories":{},"_nodeVersion":"22.13.1","dependencies":{"zod":"^3.24.2","commander":"^14.0.0","youtubei.js":"^14.0.0","@modelcontextprotocol/sdk":"1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.0.1","vitest":"^3.2.4","@vitest/ui":"^3.2.4","typescript":"^5.6.2","@types/node":"^20.11.24"},"_npmOperationalInternal":{"tmp":"tmp/mcp-youtube-transcript_0.0.13_1751508589494_0.25930415791141503","host":"s3://npm-registry-packages-npm-production"}},"0.0.14":{"name":"@gabriel3615/mcp-youtube-transcript","version":"0.0.14","keywords":["mcp","youtube","transcript","subtitles","captions","video","ai","claude","cursor","cline","modelcontextprotocol"],"author":{"name":"sinco"},"license":"MIT","_id":"@gabriel3615/mcp-youtube-transcript@0.0.14","maintainers":[{"name":"gabriel3615","email":"gabriel.liu3615@gmail.com"}],"homepage":"https://github.com/flying3615/mcp-youtube-transcript","bugs":{"url":"https://github.com/flying3615/mcp-youtube-transcript/issues"},"bin":{"youtube-transcript":"dist/cli.js","mcp-youtube-transcript":"dist/index.js"},"dist":{"shasum":"ed6a95761e3536b71a226bc2b6c43dd2b5d3eabc","tarball":"https://registry.npmjs.org/@gabriel3615/mcp-youtube-transcript/-/mcp-youtube-transcript-0.0.14.tgz","fileCount":10,"integrity":"sha512-xbI+20FWiHItXyWJHvhWtaKynElg0A+nCikymtfPmDnVclK1NDBujDV8Sr3DlQxkbWbsH81acIViakPYFwWbvg==","signatures":[{"sig":"MEYCIQCm8a56NXt/wCHQkIbyPX0F+jbBPqxVh829qe4SD4B6LQIhANJmgbr7/xXD0f7eruRxQG2Cmztohq2/V66d1ZwvPb6j","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":26908},"main":"dist/index.js","type":"module","module":"dist/index.js","engines":{"node":">=18.0.0"},"gitHead":"36d993140b2dfe53aead25759f6063e3d992b7f6","scripts":{"cli":"pnpm build && node dist/cli.js","test":"vitest run","build":"rimraf dist && tsc","test:ui":"vitest --ui","test:watch":"vitest","release:major":"npm version major && npm publish --access public","release:minor":"npm version minor && npm publish --access public","release:patch":"npm version patch && npm publish --access public","prepublishOnly":"npm run build"},"_npmUser":{"name":"gabriel3615","actor":{"name":"gabriel3615","type":"user","email":"gabriel.liu3615@gmail.com"},"email":"gabriel.liu3615@gmail.com"},"repository":{"url":"git+https://github.com/flying3615/mcp-youtube-transcript.git","type":"git"},"_npmVersion":"10.9.2","description":"A server built on the Model Context Protocol (MCP) that enables direct downloading of YouTube video transcripts, supporting AI and video analysis workflows.","directories":{},"_nodeVersion":"22.13.1","dependencies":{"zod":"^3.24.2","commander":"^14.0.0","youtubei.js":"^14.0.0","@modelcontextprotocol/sdk":"1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.0.1","vitest":"^3.2.4","@vitest/ui":"^3.2.4","typescript":"^5.6.2","@types/node":"^20.11.24"},"_npmOperationalInternal":{"tmp":"tmp/mcp-youtube-transcript_0.0.14_1751511968914_0.9511740210842374","host":"s3://npm-registry-packages-npm-production"}},"0.0.15":{"name":"@gabriel3615/mcp-youtube-transcript","version":"0.0.15","keywords":["mcp","youtube","transcript","subtitles","captions","video","ai","claude","cursor","cline","modelcontextprotocol"],"author":{"name":"sinco"},"license":"MIT","_id":"@gabriel3615/mcp-youtube-transcript@0.0.15","maintainers":[{"name":"gabriel3615","email":"gabriel.liu3615@gmail.com"}],"homepage":"https://github.com/flying3615/mcp-youtube-transcript","bugs":{"url":"https://github.com/flying3615/mcp-youtube-transcript/issues"},"bin":{"youtube-transcript":"dist/cli.js","mcp-youtube-transcript":"dist/index.js"},"dist":{"shasum":"c9d2b7b6f6b0ad07a780af2d43f788dfe4e5ac0a","tarball":"https://registry.npmjs.org/@gabriel3615/mcp-youtube-transcript/-/mcp-youtube-transcript-0.0.15.tgz","fileCount":10,"integrity":"sha512-XTk4YCWriWRlswrcmITRSNsGr64+phx+UdbipnqRmNiYUnhYSgHptE5/R5nMfXRYbkaEaksFYmCtVmhXIJo71g==","signatures":[{"sig":"MEUCIBf/uNzkUByRykZfgjAq4L5bs5RkHmbdjFL6H8diXQt8AiEA5M/DCymWWYxt7F/e3ubSitTdv11UTuynAdV5N6srqhY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27516},"main":"dist/index.js","type":"module","module":"dist/index.js","engines":{"node":">=18.0.0"},"gitHead":"aa433056228f744033a55487ee994e13997b7117","scripts":{"cli":"pnpm build && node dist/cli.js","test":"vitest run","build":"rimraf dist && tsc","test:ui":"vitest --ui","test:watch":"vitest","release:major":"npm version major && npm publish --access public","release:minor":"npm version minor && npm publish --access public","release:patch":"npm version patch && npm publish --access public","prepublishOnly":"npm run build"},"_npmUser":{"name":"gabriel3615","actor":{"name":"gabriel3615","type":"user","email":"gabriel.liu3615@gmail.com"},"email":"gabriel.liu3615@gmail.com"},"repository":{"url":"git+https://github.com/flying3615/mcp-youtube-transcript.git","type":"git"},"_npmVersion":"10.9.2","description":"A server built on the Model Context Protocol (MCP) that enables direct downloading of YouTube video transcripts, supporting AI and video analysis workflows.","directories":{},"_nodeVersion":"22.13.1","dependencies":{"zod":"^3.24.2","commander":"^14.0.0","youtubei.js":"^14.0.0","@modelcontextprotocol/sdk":"1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.0.1","vitest":"^3.2.4","@vitest/ui":"^3.2.4","typescript":"^5.6.2","@types/node":"^20.11.24"},"_npmOperationalInternal":{"tmp":"tmp/mcp-youtube-transcript_0.0.15_1751585617477_0.15522667588753336","host":"s3://npm-registry-packages-npm-production"}},"0.1.0":{"name":"@gabriel3615/mcp-youtube-transcript","version":"0.1.0","keywords":["mcp","youtube","transcript","subtitles","captions","video","ai","claude","cursor","cline","modelcontextprotocol"],"author":{"name":"sinco"},"license":"MIT","_id":"@gabriel3615/mcp-youtube-transcript@0.1.0","maintainers":[{"name":"gabriel3615","email":"gabriel.liu3615@gmail.com"}],"homepage":"https://github.com/flying3615/mcp-youtube-transcript","bugs":{"url":"https://github.com/flying3615/mcp-youtube-transcript/issues"},"bin":{"youtube-transcript":"dist/cli.js","mcp-youtube-transcript":"dist/index.js"},"dist":{"shasum":"c31b0db936c0943226b0b4d7d653d312c3068666","tarball":"https://registry.npmjs.org/@gabriel3615/mcp-youtube-transcript/-/mcp-youtube-transcript-0.1.0.tgz","fileCount":10,"integrity":"sha512-FxFYdVrzdPtCtH0GUpqyyv0zZmuLIB+YbSAmVzaKvNPn/K6i/sl2seorBHWx67/yOOO+4joRrqN6VARL+2JzPQ==","signatures":[{"sig":"MEUCIQC3FDol/4kmqDkuEnmxcGQ1nNOv7JVBmRCW5BHegLKEHgIgBplJHWWUwpyPhFA8RTarbCbNZZojV14sHFtSHyoR5ao=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31695},"main":"dist/index.js","type":"module","_from":"file:gabriel3615-mcp-youtube-transcript-0.1.0.tgz","module":"dist/index.js","engines":{"node":">=18.0.0"},"scripts":{"cli":"pnpm build && node dist/cli.js","test":"vitest run","build":"rimraf dist && tsc","test:ui":"vitest --ui","test:watch":"vitest","release:major":"npm version major && npm publish --access public","release:minor":"npm version minor && npm publish --access public","release:patch":"npm version patch && npm publish --access public"},"_npmUser":{"name":"gabriel3615","actor":{"name":"gabriel3615","type":"user","email":"gabriel.liu3615@gmail.com"},"email":"gabriel.liu3615@gmail.com"},"_resolved":"/tmp/dc87798066a88f33ae96e93b36f53b2c/gabriel3615-mcp-youtube-transcript-0.1.0.tgz","_integrity":"sha512-FxFYdVrzdPtCtH0GUpqyyv0zZmuLIB+YbSAmVzaKvNPn/K6i/sl2seorBHWx67/yOOO+4joRrqN6VARL+2JzPQ==","repository":{"url":"git+https://github.com/flying3615/mcp-youtube-transcript.git","type":"git"},"_npmVersion":"10.8.2","description":"A server built on the Model Context Protocol (MCP) that enables direct downloading of YouTube video transcripts, supporting AI and video analysis workflows.","directories":{},"_nodeVersion":"20.19.3","dependencies":{"zod":"^3.24.2","commander":"^14.0.0","youtubei.js":"^14.0.0","@modelcontextprotocol/sdk":"1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.0.1","vitest":"^3.2.4","@vitest/ui":"^3.2.4","typescript":"^5.6.2","@types/node":"^20.11.24"},"_npmOperationalInternal":{"tmp":"tmp/mcp-youtube-transcript_0.1.0_1751691395994_0.6058414269337036","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@gabriel3615/mcp-youtube-transcript","version":"0.1.1","keywords":["mcp","youtube","transcript","subtitles","captions","video","ai","claude","cursor","cline","modelcontextprotocol"],"author":{"name":"sinco"},"license":"MIT","_id":"@gabriel3615/mcp-youtube-transcript@0.1.1","maintainers":[{"name":"gabriel3615","email":"gabriel.liu3615@gmail.com"}],"homepage":"https://github.com/flying3615/mcp-youtube-transcript","bugs":{"url":"https://github.com/flying3615/mcp-youtube-transcript/issues"},"bin":{"youtube-transcript":"dist/cli.js","mcp-youtube-transcript":"dist/index.js"},"dist":{"shasum":"2875fed71ead8a79206450a39fe34c7e2440e4b3","tarball":"https://registry.npmjs.org/@gabriel3615/mcp-youtube-transcript/-/mcp-youtube-transcript-0.1.1.tgz","fileCount":10,"integrity":"sha512-0yK73Ewwughl2V3XpK6vMC2/NuHsnZF7VdETjg9pUBcrkLQEuLEwyxpKFNiRbZva1e4vADq7EjShj5RI65GAKw==","signatures":[{"sig":"MEQCIE9hGAkaIRIKtL5N3+4OeVW2RF6y7LvREIYjRXsA/CQIAiARb6QzwJlJa1omqTKE4FnY6uxKFfF+WzMK9gR4Tqebaw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31695},"main":"dist/index.js","type":"module","_from":"file:gabriel3615-mcp-youtube-transcript-0.1.1.tgz","module":"dist/index.js","engines":{"node":">=18.0.0"},"scripts":{"cli":"pnpm build && node dist/cli.js","test":"vitest run","build":"rimraf dist && tsc","test:ui":"vitest --ui","test:watch":"vitest","release:major":"npm version major && npm publish --access public","release:minor":"npm version minor && npm publish --access public","release:patch":"npm version patch && npm publish --access public"},"_npmUser":{"name":"gabriel3615","actor":{"name":"gabriel3615","type":"user","email":"gabriel.liu3615@gmail.com"},"email":"gabriel.liu3615@gmail.com"},"_resolved":"/tmp/b661c2af7069bab5c058ea88c8d3622f/gabriel3615-mcp-youtube-transcript-0.1.1.tgz","_integrity":"sha512-0yK73Ewwughl2V3XpK6vMC2/NuHsnZF7VdETjg9pUBcrkLQEuLEwyxpKFNiRbZva1e4vADq7EjShj5RI65GAKw==","repository":{"url":"git+https://github.com/flying3615/mcp-youtube-transcript.git","type":"git"},"_npmVersion":"10.8.2","description":"A server built on the Model Context Protocol (MCP) that enables direct downloading of YouTube video transcripts, supporting AI and video analysis workflows.","directories":{},"_nodeVersion":"20.19.3","dependencies":{"zod":"^3.24.2","commander":"^14.0.0","youtubei.js":"^14.0.0","@modelcontextprotocol/sdk":"1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.0.1","vitest":"^3.2.4","@vitest/ui":"^3.2.4","typescript":"^5.6.2","@types/node":"^20.11.24"},"_npmOperationalInternal":{"tmp":"tmp/mcp-youtube-transcript_0.1.1_1751691769300_0.9576838929753018","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@gabriel3615/mcp-youtube-transcript","version":"0.2.0","description":"A server built on the Model Context Protocol (MCP) that enables direct downloading of YouTube video transcripts, supporting AI and video analysis workflows.","license":"MIT","author":{"name":"sinco"},"homepage":"https://github.com/flying3615/mcp-youtube-transcript","repository":{"type":"git","url":"git+https://github.com/flying3615/mcp-youtube-transcript.git"},"bugs":{"url":"https://github.com/flying3615/mcp-youtube-transcript/issues"},"keywords":["mcp","youtube","transcript","subtitles","captions","video","ai","claude","cursor","cline","modelcontextprotocol"],"type":"module","publishConfig":{"access":"public"},"main":"dist/index.js","module":"dist/index.js","bin":{"mcp-youtube-transcript":"dist/index.js","youtube-transcript":"dist/cli.js"},"engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"1.7.0","commander":"^14.0.0","youtubei.js":"^14.0.0","zod":"^3.24.2"},"devDependencies":{"@types/node":"^20.11.24","@vitest/ui":"^3.2.4","typescript":"^5.6.2","vitest":"^3.2.4","rimraf":"^6.0.1"},"scripts":{"build":"rimraf dist && tsc","cli":"pnpm build && node dist/cli.js","test":"vitest run","test:watch":"vitest","test:ui":"vitest --ui","release:patch":"npm version patch","release:minor":"npm version minor","release:major":"npm version major"},"_id":"@gabriel3615/mcp-youtube-transcript@0.2.0","_integrity":"sha512-UMvtmql/60OVq/98GCLQq31LsQEADlQBUDSKh4tloCnsH4FdGv+u9DmvAwUT7Se4JZRmqtENF10Jd/2K9g0xeA==","_resolved":"/tmp/0acdd4f76b7a9a939a172b6e8b2980ad/gabriel3615-mcp-youtube-transcript-0.2.0.tgz","_from":"file:gabriel3615-mcp-youtube-transcript-0.2.0.tgz","_nodeVersion":"20.19.3","_npmVersion":"10.8.2","dist":{"integrity":"sha512-UMvtmql/60OVq/98GCLQq31LsQEADlQBUDSKh4tloCnsH4FdGv+u9DmvAwUT7Se4JZRmqtENF10Jd/2K9g0xeA==","shasum":"f696ec882bafe4d1a6e891b04f5d05a18c268ff3","tarball":"https://registry.npmjs.org/@gabriel3615/mcp-youtube-transcript/-/mcp-youtube-transcript-0.2.0.tgz","fileCount":10,"unpackedSize":31928,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDcZwmUqWZMrVsM1NHpQG09RXFjeqt9bldP3oKZO+EWuwIhAJfALwZ9D1xnryM3gd0DQw54hVKGUeo0eTT4fnSHGj9V"}]},"_npmUser":{"name":"gabriel3615","email":"gabriel.liu3615@gmail.com"},"directories":{},"maintainers":[{"name":"gabriel3615","email":"gabriel.liu3615@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-youtube-transcript_0.2.0_1752796897623_0.5426004646834808"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-03T02:09:49.430Z","modified":"2025-07-18T00:01:38.027Z","0.0.13":"2025-07-03T02:09:49.673Z","0.0.14":"2025-07-03T03:06:09.095Z","0.0.15":"2025-07-03T23:33:37.656Z","0.1.0":"2025-07-05T04:56:36.204Z","0.1.1":"2025-07-05T05:02:49.501Z","0.2.0":"2025-07-18T00:01:37.828Z"},"bugs":{"url":"https://github.com/flying3615/mcp-youtube-transcript/issues"},"author":{"name":"sinco"},"license":"MIT","homepage":"https://github.com/flying3615/mcp-youtube-transcript","keywords":["mcp","youtube","transcript","subtitles","captions","video","ai","claude","cursor","cline","modelcontextprotocol"],"repository":{"type":"git","url":"git+https://github.com/flying3615/mcp-youtube-transcript.git"},"description":"A server built on the Model Context Protocol (MCP) that enables direct downloading of YouTube video transcripts, supporting AI and video analysis workflows.","maintainers":[{"name":"gabriel3615","email":"gabriel.liu3615@gmail.com"}],"readme":"# MCP YouTube Transcript Server\n\nA Model Context Protocol server that enables retrieval of transcripts from YouTube videos. This server provides direct access to video transcripts through a simple interface, making it ideal for content analysis and processing.\n\n\n## Table of Contents\n- [Features](#features)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n- [Usage](#usage)\n  - [Basic Configuration](#basic-configuration)\n  - [Testing](#testing)\n  - [Troubleshooting and Maintenance](#troubleshooting-and-maintenance)\n- [API Reference](#api-reference)\n- [Development](#development)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Features\n\n✨ Key capabilities:\n- Extract transcripts from YouTube videos\n- Support for multiple languages\n- Format text with continuous or paragraph mode\n- Retrieve video titles and metadata\n- Automatic paragraph segmentation\n- Text normalization and HTML entity decoding\n- Robust error handling\n- Timestamp and overlap detection\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js 18 or higher\n\n### Installation\n\nWe provide two installation methods:\n\n#### Option 1: Manual Configuration (Recommended for Production)\n\n1. Create or edit the Claude Desktop configuration file:\n   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n   - Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n2. Add the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"youtube-transcript\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@gabriel3615/mcp-youtube-transcript\"\n      ]\n    }\n  }\n}\n```\n\nQuick setup script for macOS:\n\n```bash\n# Create directory if it doesn't exist\nmkdir -p ~/Library/Application\\ Support/Claude\n\n# Create or update config file\ncat > ~/Library/Application\\ Support/Claude/claude_desktop_config.json << 'EOL'\n{\n  \"mcpServers\": {\n    \"youtube-transcript\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@gabriel3615/mcp-youtube-transcript\"\n      ]\n    }\n  }\n}\nEOL\n\n```\n## Usage\n\n### Basic Configuration\n\nTo use with Claude Desktop / Cursor / cline, ensure your configuration matches:\n\n```json\n{\n  \"mcpServers\": {\n    \"youtube-transcript\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@gabriel3615/mcp-youtube-transcript\"]\n    }\n  }\n}\n```\n\n### Testing\n\n#### With Claude App\n\n1. Restart the Claude app after installation\n2. Test with a simple command:\n   ```plaintext\n   https://www.youtube.com/watch?v=AJpK3YTTKZ4 Summarize this video\n   ```\n\nExample output:\n![Demo](./assets/demo.png)\n\n#### With MCP Inspector\n\n```bash\n# Clone and setup\ngit clone https://github.com/flying3615/mcp-youtube-transcript.git\ncd mcp-youtube-transcript\nnpm install\nnpm run build\n\n# Launch inspector\nnpx @modelcontextprotocol/inspector node \"dist/index.js\"\n\n# Access http://localhost:6274 and try these commands:\n# 1. Paste the session id to pass authentication\n# 2. List Tools: clink `List Tools`\n# 3. Test get_transcripts with:\n#    url: \"https://www.youtube.com/watch?v=LCEmiRjPEtQ\"\n#    lang: \"en\" (optional)\n#    enableParagraphs: false (optional)\n```\n\n### Troubleshooting and Maintenance\n\n#### Checking Claude Logs\n\nTo monitor Claude's logs, you can use the following command:\n\n```bash\ntail -n 20 -f ~/Library/Logs/Claude/mcp*.log\n```\n\nThis will display the last 20 lines of the log file and continue to show new entries as they are added.\n\n> **Note**: Claude app automatically prefixes MCP server log files with `mcp-server-`. For example, our server's logs will be written to `mcp-server-youtube-transcript.log`.\n\n#### Cleaning the `npx` Cache\n\nIf you encounter issues related to the `npx` cache, you can manually clean it using:\n\n```bash\nrm -rf ~/.npm/_npx\n```\n\nThis will remove the cached packages and allow you to start fresh.\n\n## API Reference\n\n### get_transcripts\n\nFetches transcripts from YouTube videos.\n\n**Parameters:**\n- `url` (string, required): YouTube video URL or ID\n- `lang` (string, optional): Language code (default: \"en\")\n- `enableParagraphs` (boolean, optional): Enable paragraph mode (default: false)\n\n**Response Format:**\n```json\n{\n  \"content\": [{\n    \"type\": \"text\",\n    \"text\": \"Video title and transcript content\",\n    \"metadata\": {\n      \"videoId\": \"video_id\",\n      \"title\": \"video_title\",\n      \"language\": \"transcript_language\",\n      \"timestamp\": \"processing_time\",\n      \"charCount\": \"character_count\",\n      \"transcriptCount\": \"number_of_transcripts\",\n      \"totalDuration\": \"total_duration\",\n      \"paragraphsEnabled\": \"paragraph_mode_status\"\n    }\n  }]\n}\n```\n\n### download_video\n\nDownloads a video from YouTube.\n\n**Parameters:**\n- `url` (string, required): YouTube video URL or ID\n- `output` (string, optional): The path to save the video file (default: \"video.mp4\")\n\n**Response Format:**\n```json\n{\n  \"content\": [{\n    \"type\": \"text\",\n    \"text\": \"Video successfully downloaded to video.mp4\",\n    \"metadata\": {\n      \"videoId\": \"video_id\",\n      \"path\": \"video.mp4\",\n      \"timestamp\": \"processing_time\"\n    }\n  }]\n}\n```\n\n## Development\n\n### Project Structure\n\n```\n├── src/\n│ ├── index.ts            # Server entry point\n│ ├── index.ts          # YouTube transcript fetching logic\n├── dist/                 # Compiled output\n└── package.json\n```\n\n### Key Components\n\n- `YouTubeTranscriptFetcher`: Core transcript fetching functionality\n- `YouTubeUtils`: Text processing and utilities\n\n### Features and Capabilities\n\n- **Error Handling:**\n  - Invalid URLs/IDs\n  - Unavailable transcripts\n  - Language availability\n  - Network errors\n  - Rate limiting\n\n- **Text Processing:**\n  - HTML entity decoding\n  - Punctuation normalization\n  - Space normalization\n  - Smart paragraph detection\n\n## Contributing\n\nWe welcome contributions! Please feel free to submit issues and pull requests.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Related Projects\n\n- [mcp-servers](https://github.com/modelcontextprotocol/servers)\n- [MCP Inspector](https://github.com/modelcontextprotocol/inspector)\n","readmeFilename":"README.md"}