{
  "markdown": "# MCP Video Cloud Server\n\nA **Remote** Model Context Protocol (MCP) server that downloads videos from social media platforms (YouTube, Facebook, Instagram, TikTok, etc.) and stores them in S3-compatible cloud storage, returning publicly accessible URLs. \n\n**✨ Optimized for Smithery.ai deployment** - Deploy in minutes with one-click setup!\n\n## 🚀 Quick Deploy to Smithery.ai\n\n1. **Fork this repository** to your GitHub account\n2. **Set up Cloudflare R2** (or AWS S3) storage\n3. **Deploy on Smithery.ai** - Click \"Deploy\" and connect your GitHub repo\n4. **Configure your S3 credentials** in Smithery's interface\n5. **Start using** - Connect to Claude Desktop and download videos!\n\n👉 **[See detailed deployment instructions](DEPLOYMENT.md)**\n\n## ✨ Features\n\n- **Multi-Platform Support**: Download from 1000+ sites via yt-dlp\n- **Cloud Storage**: Automatic upload to S3/R2 with public URLs\n- **Transcript Extraction**: Get clean text transcripts\n- **Thumbnail Extraction**: Extract video thumbnails\n- **Audio Extraction**: Extract audio in MP3 format\n- **Metadata Retrieval**: Get comprehensive video information\n- **Remote Access**: Runs in the cloud, no local setup needed\n- **Smithery Integration**: One-click deployment and scaling\n\n## 🎯 Supported Platforms\n\n- YouTube\n- Facebook\n- Instagram\n- TikTok\n- Twitter/X\n- Vimeo\n- Twitch\n- And 1000+ other sites\n\n## 🛠️ Available Tools\n\n### `download_video_to_cloud`\nDownload a video and store it in cloud storage.\n- **Input**: Video URL, quality preference\n- **Output**: Public URL, filename, file size, metadata\n\n### `download_audio_to_cloud`\nExtract audio from a video and store it in cloud storage.\n- **Input**: Video URL\n- **Output**: Public URL, filename, file size, metadata\n\n### `extract_transcript_to_cloud`\nExtract subtitles/transcript and store as clean text.\n- **Input**: Video URL, language code\n- **Output**: Public URL, filename, transcript preview\n\n### `extract_thumbnail_to_cloud`\nExtract video thumbnail and store it in cloud storage.\n- **Input**: Video URL\n- **Output**: Public URL, filename\n\n### `get_video_metadata`\nGet comprehensive video information without downloading.\n- **Input**: Video URL\n- **Output**: Title, uploader, duration, views, description, etc.\n\n## 🔧 Configuration\n\nThe server requires S3-compatible storage configuration:\n\n```yaml\ns3Endpoint: https://your-account.r2.cloudflarestorage.com\ns3Region: auto\ns3AccessKeyId: your-access-key\ns3SecretAccessKey: your-secret-key\ns3BucketName: your-bucket-name\ns3PublicUrlBase: https://your-custom-domain.com  # Optional\n```\n\n## 📁 File Organization\n\nFiles are organized in your S3 bucket:\n- `videos/` - Downloaded video files\n- `audio/` - Extracted audio files\n- `transcripts/` - Transcript text files\n- `thumbnails/` - Thumbnail images\n\n## 🔒 Security & Privacy\n\n- All files stored in **your own** S3 bucket\n- No data permanently stored on the server\n- Temporary files automatically cleaned up\n- Credentials securely managed by Smithery\n- Server runs in isolated containers\n\n## 💰 Cost Considerations\n\n- **Smithery Hosting**: Check current pricing plans\n- **Cloudflare R2**: ~$0.015/GB/month storage + bandwidth\n- **Processing**: Included in Smithery hosting\n\n## 🏃‍♂️ Local Development\n\nIf you want to run locally for development:\n\n### Prerequisites\n- Node.js 20+\n- yt-dlp installed\n- S3 credentials\n\n### Setup\n```bash\ngit clone <your-fork>\ncd mcp-video-cloud-server\nnpm install\nnpm run build:stdio\n```\n\n### Environment Variables\n```bash\nS3_ENDPOINT=your-endpoint\nS3_REGION=auto\nS3_ACCESS_KEY_ID=your-key\nS3_SECRET_ACCESS_KEY=your-secret\nS3_BUCKET_NAME=your-bucket\n```\n\n### Run\n```bash\nnpm run start:stdio\n```\n\n## 🧪 Testing with Smithery\n\nUse Smithery's development environment:\n\n```bash\nnpm run dev\n```\n\nThis starts a development server with the Smithery playground for testing.\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Test with `npm run dev`\n5. Submit a pull request\n\n## 📄 License\n\nMIT License - see LICENSE file for details\n\n## 🆘 Support\n\n- **Deployment Issues**: Check [DEPLOYMENT.md](DEPLOYMENT.md)\n- **Smithery Support**: Visit https://smithery.ai/support\n- **Bug Reports**: Create a GitHub issue\n- **Feature Requests**: Create a GitHub issue\n\n---\n\n**Ready to deploy?** 👉 **[Follow the deployment guide](DEPLOYMENT.md)**\n\n",
  "bytes": 4316,
  "sha": "d61766b1a62ec82203a908f1d42d44a299f70d1e830b46081cff371ff57c9e1e",
  "repo_slug": "ctaylor86/mcp-video-download-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_smithery_ctaylor86_mcp_video_download_c58fb00f/readme"
}