mcp-video-download-server

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

1. Fork this repository to your GitHub account
2. Set up Cloudflare R2 (or AWS S3) storage
3. Deploy on Smithery.ai - Click "Deploy" and connect your GitHub repo
4. Configure your S3 credentials in Smithery's interface
5. 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 files
• audio/ - Extracted audio files
• transcripts/ - Transcript text files
• thumbnails/ - 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

npm run start:stdio

🧪 Testing with Smithery

Use Smithery's development environment:

npm run dev

This starts a development server with the Smithery playground for testing.

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test with npm run dev
5. Submit a pull request

📄 License

MIT License - see LICENSE file for details

🆘 Support

• Deployment Issues: Check DEPLOYMENT.md
• Smithery Support: Visit https://smithery.ai/support
• Bug Reports: Create a GitHub issue
• Feature Requests: Create a GitHub issue

---

Ready to deploy? 👉 Follow the deployment guide