{"_id":"@iflow-mcp/mcp-youtube-transcript","name":"@iflow-mcp/mcp-youtube-transcript","dist-tags":{"latest":"0.0.8"},"versions":{"0.0.8":{"name":"@iflow-mcp/mcp-youtube-transcript","version":"0.0.8","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/sinco-lab/mcp-youtube-transcript","repository":{"type":"git","url":"git+https://github.com/sinco-lab/mcp-youtube-transcript.git"},"bugs":{"url":"https://github.com/sinco-lab/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"},"engines":{"node":">=18.0.0"},"scripts":{"build":"tsc && chmod +x dist/*.js","clean":"rm -rf dist","prepublishOnly":"npm run clean && npm run build","release:patch":"npm version patch && git push origin v$(node -p \"require('./package.json').version\")","release:minor":"npm version minor && git push origin v$(node -p \"require('./package.json').version\")","release:major":"npm version major && git push origin v$(node -p \"require('./package.json').version\")"},"dependencies":{"@modelcontextprotocol/sdk":"1.7.0","zod":"^3.24.2"},"devDependencies":{"@types/node":"^20.11.24","typescript":"^5.6.2"},"gitHead":"bc84da0c8fb4750ec59d295045bd821386ef0d72","_id":"@iflow-mcp/mcp-youtube-transcript@0.0.8","_nodeVersion":"24.1.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-kjERU3SAwt8dSVUYWk8FIgFeu71EZXaVoCj02BakNaKBpASKlROd4SQfjT09uSnwXb29p0dppjC2CSOrC0gAmA==","shasum":"0f63bf7d63dacd10b30f7b5c0034ed7a5c319a1a","tarball":"https://registry.npmjs.org/@iflow-mcp/mcp-youtube-transcript/-/mcp-youtube-transcript-0.0.8.tgz","fileCount":5,"unpackedSize":28655,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICRyEIbFqxv76mvrSkl88qXdYj16ALxd88i8BJn+c2m3AiEA/M3Jgx5biW7B5CizXS/ZXSuKy4zX7/YM8+TEro9WDgw="}]},"_npmUser":{"name":"chatflowdev","email":"chatflowdev@gmail.com"},"directories":{},"maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-youtube-transcript_0.0.8_1763951644271_0.8481241855321828"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-24T02:34:04.215Z","0.0.8":"2025-11-24T02:34:04.480Z","modified":"2025-11-24T02:34:04.745Z"},"maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"description":"A server built on the Model Context Protocol (MCP) that enables direct downloading of YouTube video transcripts, supporting AI and video analysis workflows.","homepage":"https://github.com/sinco-lab/mcp-youtube-transcript","keywords":["mcp","youtube","transcript","subtitles","captions","video","ai","claude","cursor","cline","modelcontextprotocol"],"repository":{"type":"git","url":"git+https://github.com/sinco-lab/mcp-youtube-transcript.git"},"author":{"name":"sinco"},"bugs":{"url":"https://github.com/sinco-lab/mcp-youtube-transcript/issues"},"license":"MIT","readme":"# MCP YouTube Transcript Server\n\n[![smithery badge](https://smithery.ai/badge/@sinco-lab/mcp-youtube-transcript)](https://smithery.ai/server/@sinco-lab/mcp-youtube-transcript)\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<a href=\"https://glama.ai/mcp/servers/@sinco-lab/mcp-youtube-transcript\">\n  <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@sinco-lab/mcp-youtube-transcript/badge\" alt=\"mcp-youtube-transcript\" />\n</a>\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        \"@sinco-lab/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        \"@sinco-lab/mcp-youtube-transcript\"\n      ]\n    }\n  }\n}\nEOL\n```\n\n#### Option 2: Via Smithery (Development Only)\n\n```bash\nnpx -y @smithery/cli install @sinco-lab/mcp-youtube-transcript --client claude\n```\n\n⚠️ **Note**: This method is not recommended for production use as it relies on Smithery's proxy services.\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\", \"@sinco-lab/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/sinco-lab/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. List Tools: clink `List Tools`\n# 2. Test get_transcripts with:\n#    url: \"https://www.youtube.com/watch?v=AJpK3YTTKZ4\"\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## Development\n\n### Project Structure\n\n```\n├── src/\n│ ├── index.ts            # Server entry point\n│ ├── youtube.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","_rev":"1-526bba95a8fec330eace5f689fb6838b"}