{"_id":"my-youtube-data-mcp","_rev":"4-72a5a14cbba49a07a150eb5f66e5d837","name":"my-youtube-data-mcp","dist-tags":{"latest":"1.0.18"},"versions":{"1.0.15":{"name":"my-youtube-data-mcp","version":"1.0.15","keywords":["mcp","youtube","claude","modelcontextprotocol"],"author":{"name":"mychox68"},"license":"MIT","_id":"my-youtube-data-mcp@1.0.15","maintainers":[{"name":"mychox68","email":"mychoxx@gmail.com"}],"homepage":"https://github.com/mychox68/my-youtube-data-mcp#readme","bugs":{"url":"https://github.com/mychox68/my-youtube-data-mcp/issues"},"bin":{"my-youtube-data-mcp":"dist/index.js"},"dist":{"shasum":"764a40f12cded16dd9f1981b0c678f07b4fb6ee3","tarball":"https://registry.npmjs.org/my-youtube-data-mcp/-/my-youtube-data-mcp-1.0.15.tgz","fileCount":8,"integrity":"sha512-03HmVfjNfuts38YCpvMWPd3c+Kl/q2lDIn9FglJ4/JqCy1xNKdkG0MNv8H+QK7Kj6cAz8B52vZfwXlmC9nD5mw==","signatures":[{"sig":"MEUCIQC7OedlaCh2g2Yu7RJI0PviWEOmyka+WlrWqgvxaBhX2AIgcA7nwTbR92UjTl/7/L8E9GSDnzOT9e74+sjrWqagrTk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31440},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"ac6542e60c1903d36413bf11915cb44361bed8fc","scripts":{"dev":"nodemon --exec ts-node --esm ./src/index.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","clean":"rimraf dist","start":"node dist/index.js","prepare":"npm run build","prebuild":"npm run clean"},"_npmUser":{"name":"mychox68","email":"mychoxx@gmail.com"},"repository":{"url":"git+https://github.com/mychox68/my-youtube-data-mcp.git","type":"git"},"_npmVersion":"11.5.2","description":"YouTube MCP Server Implementation","directories":{},"_nodeVersion":"22.18.0","dependencies":{"zod":"^3.24.2","pnpm":"^10.6.4","dotenv":"^16.4.7","googleapis":"^129.0.0","youtube-captions-scraper":"^2.0.0","@modelcontextprotocol/sdk":"^1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.57.0","rimraf":"^5.0.10","nodemon":"^3.0.0","ts-jest":"^29.1.2","ts-node":"^10.9.1","typescript":"^5.0.0","@types/jest":"^29.5.12","@types/node":"^18.0.0","@typescript-eslint/parser":"^7.1.0","@typescript-eslint/eslint-plugin":"^7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/my-youtube-data-mcp_1.0.15_1761035910790_0.917112677350205","host":"s3://npm-registry-packages-npm-production"}},"1.0.16":{"name":"my-youtube-data-mcp","version":"1.0.16","keywords":["mcp","youtube","claude","modelcontextprotocol"],"author":{"name":"mychox68"},"license":"MIT","_id":"my-youtube-data-mcp@1.0.16","maintainers":[{"name":"mychox68","email":"mychoxx@gmail.com"}],"homepage":"https://github.com/mychox68/my-youtube-data-mcp#readme","bugs":{"url":"https://github.com/mychox68/my-youtube-data-mcp/issues"},"bin":{"my-youtube-data-mcp":"dist/index.js"},"dist":{"shasum":"17a860a6519b3f75e17d247f2efaab27e4696f60","tarball":"https://registry.npmjs.org/my-youtube-data-mcp/-/my-youtube-data-mcp-1.0.16.tgz","fileCount":8,"integrity":"sha512-rolc4mRI76GcglEeW8Vvy8pAQ9tcbH+IsQ5UTaoFw/BDq4DIq2n04zgZ+db/uc6D5PV4ppCeTMQbrRKA5GblWg==","signatures":[{"sig":"MEQCIB5eq0nAzFRsVCb3umzNBJaXM9ysjaWQLrcALghYwh9uAiA3sPncqtBK2vDRG0nhhcuChQ0XQU1Gooxq26UdW4sdYQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31440},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"a1eadab57e16c44e96c56dd622f406109221cf8f","scripts":{"dev":"nodemon --exec ts-node --esm ./src/index.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","clean":"rimraf dist","start":"node dist/index.js","prepare":"npm run build","prebuild":"npm run clean"},"_npmUser":{"name":"mychox68","email":"mychoxx@gmail.com"},"repository":{"url":"git+https://github.com/mychox68/my-youtube-data-mcp.git","type":"git"},"_npmVersion":"11.5.2","description":"YouTube MCP Server Implementation","directories":{},"_nodeVersion":"22.18.0","dependencies":{"zod":"^3.24.2","pnpm":"^10.6.4","dotenv":"^16.4.7","googleapis":"^129.0.0","youtube-captions-scraper":"^2.0.0","@modelcontextprotocol/sdk":"^1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.57.0","rimraf":"^5.0.10","nodemon":"^3.0.0","ts-jest":"^29.1.2","ts-node":"^10.9.1","typescript":"^5.0.0","@types/jest":"^29.5.12","@types/node":"^18.0.0","@typescript-eslint/parser":"^7.1.0","@typescript-eslint/eslint-plugin":"^7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/my-youtube-data-mcp_1.0.16_1761036778791_0.42402173426028544","host":"s3://npm-registry-packages-npm-production"}},"1.0.17":{"name":"my-youtube-data-mcp","version":"1.0.17","keywords":["mcp","youtube","claude","modelcontextprotocol"],"author":{"name":"mychox68"},"license":"MIT","_id":"my-youtube-data-mcp@1.0.17","maintainers":[{"name":"mychox68","email":"mychoxx@gmail.com"}],"homepage":"https://github.com/mychox68/my-youtube-data-mcp#readme","bugs":{"url":"https://github.com/mychox68/my-youtube-data-mcp/issues"},"bin":{"my-youtube-data-mcp":"dist/index.js"},"dist":{"shasum":"86ebe0fafbd5b50838ca120275ddec22abd8560e","tarball":"https://registry.npmjs.org/my-youtube-data-mcp/-/my-youtube-data-mcp-1.0.17.tgz","fileCount":8,"integrity":"sha512-EthLAxmiw8YkQOROsqWYy2OOkWb0S9BwHhwYN9JU34rqGVangkdO5zYGlNR83pHvC0Xy7/XMTDMn9E4TaY9sWg==","signatures":[{"sig":"MEUCIQDEm8ejA4CtlgCNdDwzDTgz2nytTjpt21ZNiDT0zp+GTQIgG8SBkiWV+6PmY1jekUDLBJvh7tXYEjJpRrmS68qEj2Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31440},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"88172336fd036c57322d99735603a96c68d80f98","scripts":{"dev":"nodemon --exec ts-node --esm ./src/index.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","clean":"rimraf dist","start":"node dist/index.js","prepare":"npm run build","prebuild":"npm run clean"},"_npmUser":{"name":"mychox68","email":"mychoxx@gmail.com"},"repository":{"url":"git+https://github.com/mychox68/my-youtube-data-mcp.git","type":"git"},"_npmVersion":"11.5.2","description":"YouTube MCP Server Implementation","directories":{},"_nodeVersion":"22.18.0","dependencies":{"zod":"^3.24.2","pnpm":"^10.6.4","dotenv":"^16.4.7","googleapis":"^129.0.0","youtube-captions-scraper":"^2.0.0","@modelcontextprotocol/sdk":"^1.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.57.0","rimraf":"^5.0.10","nodemon":"^3.0.0","ts-jest":"^29.1.2","ts-node":"^10.9.1","typescript":"^5.0.0","@types/jest":"^29.5.12","@types/node":"^18.0.0","@typescript-eslint/parser":"^7.1.0","@typescript-eslint/eslint-plugin":"^7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/my-youtube-data-mcp_1.0.17_1761038027111_0.6628057753038261","host":"s3://npm-registry-packages-npm-production"}},"1.0.18":{"name":"my-youtube-data-mcp","version":"1.0.18","description":"YouTube MCP Server Implementation","main":"dist/index.js","type":"module","bin":{"my-youtube-data-mcp":"dist/index.js"},"scripts":{"start":"node dist/index.js","dev":"nodemon --exec ts-node --esm ./src/index.ts","build":"tsc","clean":"rimraf dist","prebuild":"npm run clean","lint":"eslint src/**/*.ts","test":"jest","prepare":"npm run build"},"keywords":["mcp","youtube","claude","modelcontextprotocol"],"author":{"name":"mychox68"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/mychox68/my-youtube-data-mcp.git"},"homepage":"https://github.com/mychox68/my-youtube-data-mcp#readme","bugs":{"url":"https://github.com/mychox68/my-youtube-data-mcp/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^1.7.0","dotenv":"^16.4.7","googleapis":"^129.0.0","pnpm":"^10.6.4","youtube-captions-scraper":"^2.0.0","zod":"^3.24.2"},"devDependencies":{"@types/jest":"^29.5.12","@types/node":"^18.0.0","@typescript-eslint/eslint-plugin":"^7.1.0","@typescript-eslint/parser":"^7.1.0","eslint":"^8.57.0","jest":"^29.7.0","nodemon":"^3.0.0","rimraf":"^5.0.10","ts-jest":"^29.1.2","ts-node":"^10.9.1","typescript":"^5.0.0"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"_id":"my-youtube-data-mcp@1.0.18","gitHead":"e3115b04d94f0a495e114cd05fe7c2c269519fbd","types":"./dist/index.d.ts","_nodeVersion":"22.18.0","_npmVersion":"11.5.2","dist":{"integrity":"sha512-g1LAfLSOlb5TIFhC7IuhEpJ31Wsrl9HMr443o0sP6RNqOSDKT+3WnNxKlOZkYEnHph6tSlN4adEM1pb9I/DAcQ==","shasum":"80571eebe5da9c3e2027fde2729373cbafcfe19d","tarball":"https://registry.npmjs.org/my-youtube-data-mcp/-/my-youtube-data-mcp-1.0.18.tgz","fileCount":8,"unpackedSize":31440,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC99Z+F5n3MQBLxGvRHwRDNmMmltoIXfe22kzF8svhCvwIhAMVXRe9yi157sGr7TUXlx/JLN5Zjduq7hEgBTy+VRcwx"}]},"_npmUser":{"name":"mychox68","email":"mychoxx@gmail.com"},"directories":{},"maintainers":[{"name":"mychox68","email":"mychoxx@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/my-youtube-data-mcp_1.0.18_1761038665745_0.016622994965694637"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-21T08:38:30.682Z","modified":"2025-10-21T09:24:26.086Z","1.0.15":"2025-10-21T08:38:30.978Z","1.0.16":"2025-10-21T08:52:58.979Z","1.0.17":"2025-10-21T09:13:47.295Z","1.0.18":"2025-10-21T09:24:25.903Z"},"bugs":{"url":"https://github.com/mychox68/my-youtube-data-mcp/issues"},"author":{"name":"mychox68"},"license":"MIT","homepage":"https://github.com/mychox68/my-youtube-data-mcp#readme","keywords":["mcp","youtube","claude","modelcontextprotocol"],"repository":{"type":"git","url":"git+https://github.com/mychox68/my-youtube-data-mcp.git"},"description":"YouTube MCP Server Implementation","maintainers":[{"name":"mychox68","email":"mychoxx@gmail.com"}],"readme":"# YouTube MCP Server\r\n\r\nA Model Context Protocol (MCP) server implementation utilizing the YouTube Data API. It allows AI language models to interact with YouTube content through a standardized interface.\r\n\r\n## Key Features\r\n\r\n### Video Information\r\n* Retrieve detailed video information (title, description, duration, statistics)\r\n* Search for videos by keywords\r\n* Get related videos based on a specific video\r\n* Calculate and analyze video engagement ratios\r\n\r\n### Transcript/Caption Management\r\n* Retrieve video captions with multi-language support\r\n* Specify language preferences for transcripts\r\n* Access time-stamped captions for precise content reference\r\n\r\n### Channel Analysis\r\n* View detailed channel statistics (subscribers, views, video count)\r\n* Get top-performing videos from a channel\r\n* Analyze channel growth and engagement metrics\r\n\r\n### Trend Analysis\r\n* View trending videos by region and category\r\n* Compare performance metrics across multiple videos\r\n* Discover popular content in specific categories\r\n\r\n## Available Tools\r\n\r\nThe server provides the following MCP tools:\r\n\r\n| Tool Name | Description | Required Parameters |\r\n|-----------|-------------|---------------------|\r\n| `getVideoDetails` | Get detailed information about multiple YouTube videos including metadata, statistics, and content details | `videoIds` (array) |\r\n| `searchVideos` | Search for videos based on a query string | `query`, `maxResults` (optional) |\r\n| `getTranscripts` | Retrieve transcripts for multiple videos | `videoIds` (array), `lang` (optional) |\r\n| `getRelatedVideos` | Get videos related to a specific video based on YouTube's recommendation algorithm | `videoId`, `maxResults` (optional) |\r\n| `getChannelStatistics` | Retrieve detailed metrics for multiple channels including subscriber count, view count, and video count | `channelIds` (array) |\r\n| `getChannelTopVideos` | Get the most viewed videos from a specific channel | `channelId`, `maxResults` (optional) |\r\n| `getVideoEngagementRatio` | Calculate engagement metrics for multiple videos (views, likes, comments, and engagement ratio) | `videoIds` (array) |\r\n| `getTrendingVideos` | Get currently popular videos by region and category | `regionCode` (optional), `categoryId` (optional), `maxResults` (optional) |\r\n| `compareVideos` | Compare statistics across multiple videos | `videoIds` (array) |\r\n\r\n## Installation\r\n\r\n### Automatic Installation via Smithery\r\n\r\nAutomatically install YouTube MCP Server for Claude Desktop via [Smithery](https://smithery.ai/server/@mychox68/my-youtube-data-mcp):\r\n\r\n```bash\r\nnpx -y @smithery/cli install @mychox68/my-youtube-data-mcp --client claude\r\n```\r\n\r\n### Manual Installation\r\n```bash\r\n# Install from npm\r\nnpm install my-youtube-data-mcp\r\n\r\n# Or clone repository\r\ngit clone https://github.com/mychox68/my-youtube-data-mcp.git\r\ncd my-youtube-data-mcp\r\nnpm install\r\n```\r\n\r\n## Environment Configuration\r\nSet the following environment variables:\r\n* `YOUTUBE_API_KEY`: YouTube Data API key (required)\r\n* `YOUTUBE_TRANSCRIPT_LANG`: Default caption language (optional, default: 'ko')\r\n\r\n## MCP Client Configuration\r\nAdd the following to your Claude Desktop configuration file:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"youtube\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"my-youtube-data-mcp\"],\r\n      \"env\": {\r\n        \"YOUTUBE_API_KEY\": \"YOUR_API_KEY_HERE\",\r\n        \"YOUTUBE_TRANSCRIPT_LANG\": \"ko\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## YouTube API Setup\r\n1. Access Google Cloud Console\r\n2. Create a new project or select an existing one\r\n3. Enable YouTube Data API v3\r\n4. Create API credentials (API key)\r\n5. Use the generated API key in your environment configuration\r\n\r\n## Development\r\n\r\n```bash\r\n# Install dependencies\r\nnpm install\r\n\r\n# Run in development mode\r\nnpm run dev\r\n\r\n# Build\r\nnpm run build\r\n```\r\n\r\n## Network Configuration\r\n\r\nThe server exposes the following ports for communication:\r\n- HTTP: 3000\r\n- gRPC: 3001\r\n\r\n## System Requirements\r\n- Node.js 18.0.0 or higher\r\n\r\n## Security Considerations\r\n- Always keep your API key secure and never commit it to version control systems\r\n- Manage your API key through environment variables or configuration files\r\n- Set usage limits for your API key to prevent unauthorized use\r\n\r\n## License\r\nThis project is licensed under the MIT License. See the LICENSE file for details. \r\n","readmeFilename":"README.md"}