MCP Video Cloud Server
A 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.
✨ Optimized for Smithery.ai deployment - Deploy in minutes with one-click setup!
🚀 Quick Deploy to Smithery.ai
- Fork this repository to your GitHub account
- Set up Cloudflare R2 (or AWS S3) storage
- Deploy on Smithery.ai - Click "Deploy" and connect your GitHub repo
- Configure your S3 credentials in Smithery's interface
- Start using - Connect to Claude Desktop and download videos!
👉 See detailed deployment instructions
✨ Features
- Multi-Platform Support: Download from 1000+ sites via yt-dlp
- Cloud Storage: Automatic upload to S3/R2 with public URLs
- Transcript Extraction: Get clean text transcripts
- Thumbnail Extraction: Extract video thumbnails
- Audio Extraction: Extract audio in MP3 format
- Metadata Retrieval: Get comprehensive video information
- Remote Access: Runs in the cloud, no local setup needed
- Smithery Integration: One-click deployment and scaling
🎯 Supported Platforms
- YouTube
- Facebook
- Instagram
- TikTok
- Twitter/X
- Vimeo
- Twitch
- And 1000+ other sites
🛠️ Available Tools
download_video_to_cloud
Download a video and store it in cloud storage.
- Input: Video URL, quality preference
- Output: Public URL, filename, file size, metadata
download_audio_to_cloud
Extract audio from a video and store it in cloud storage.
- Input: Video URL
- Output: Public URL, filename, file size, metadata
extract_transcript_to_cloud
Extract subtitles/transcript and store as clean text.
- Input: Video URL, language code
- Output: Public URL, filename, transcript preview
extract_thumbnail_to_cloud
Extract video thumbnail and store it in cloud storage.
- Input: Video URL
- Output: Public URL, filename
get_video_metadata
Get comprehensive video information without downloading.
- Input: Video URL
- Output: Title, uploader, duration, views, description, etc.
🔧 Configuration
The server requires S3-compatible storage configuration:
s3Endpoint: https://your-account.r2.cloudflarestorage.com
s3Region: auto
s3AccessKeyId: your-access-key
s3SecretAccessKey: your-secret-key
s3BucketName: your-bucket-name
s3PublicUrlBase: https://your-custom-domain.com # Optional
📁 File Organization
Files are organized in your S3 bucket:
videos/ - Downloaded video filesaudio/ - Extracted audio filestranscripts/ - Transcript text filesthumbnails/ - Thumbnail images
🔒 Security & Privacy
- All files stored in your own S3 bucket
- No data permanently stored on the server
- Temporary files automatically cleaned up
- Credentials securely managed by Smithery
- Server runs in isolated containers
💰 Cost Considerations
- Smithery Hosting: Check current pricing plans
- Cloudflare R2: ~$0.015/GB/month storage + bandwidth
- Processing: Included in Smithery hosting
🏃♂️ Local Development
If you want to run locally for development:
Prerequisites
- Node.js 20+
- yt-dlp installed
- S3 credentials
Setup
git clone <your-fork>
cd mcp-video-cloud-server
npm install
npm run build:stdio
Environment Variables
S3_ENDPOINT=your-endpoint
S3_REGION=auto
S3_ACCESS_KEY_ID=your-key
S3_SECRET_ACCESS_KEY=your-secret
S3_BUCKET_NAME=your-bucket
Run
🧪 Testing with Smithery
Use Smithery's development environment:
This starts a development server with the Smithery playground for testing.
🤝 Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Test with
npm run dev
- Submit a pull request
📄 License
MIT License - see LICENSE file for details
🆘 Support
Ready to deploy? 👉 Follow the deployment guide