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

Related MCP server: video-url-parser

✨ 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