ctaylor86-mcp-video-download-server

MCP 视频云服务

一个远程模型上下文协议（MCP）服务，可从社交媒体平台（YouTube、Facebook、Instagram、TikTok 等）下载视频，并将其存储到兼容 S3 的云存储中，返回可公开访问的 URL。

✨ 针对 Smithery.ai 部署进行了优化——几分钟即可完成部署，一键设置！

🚀 快速部署到 Smithery.ai

1. Fork 此仓库到你的 GitHub 账户
2. 设置 Cloudflare R2（或 AWS S3）存储
3. 在 Smithery.ai 上部署——点击“Deploy”并连接你的 GitHub 仓库
4. 在 Smithery 的界面中配置 S3 凭据
5. 开始使用——连接到 Claude Desktop 并下载视频！

👉 查看详细部署说明

✨ 功能

• 多平台支持：通过 yt-dlp 从 1000 多个网站下载
• 云存储：自动上传到 S3/R2 并生成公开 URL
• 字幕提取：获取整洁的文本字幕
• 缩略图提取：提取视频缩略图
• 音频提取：提取 MP3 格式的音频
• 元数据获取：获取全面的视频信息
• 远程访问：在云端运行，无需本地设置
• Smithery 集成：一键部署和扩展

🎯 支持的平台

• YouTube
• Facebook
• Instagram
• TikTok
• Twitter/X
• Vimeo
• Twitch
• 以及其他 1000 多个网站

🛠️ 可用工具

download_video_to_cloud

下载视频并将其存储到云存储中。

• 输入：视频 URL、画质偏好
• 输出：公开 URL、文件名、文件大小、元数据

download_audio_to_cloud

从视频中提取音频并将其存储到云存储中。

• 输入：视频 URL
• 输出：公开 URL、文件名、文件大小、元数据

extract_transcript_to_cloud

提取字幕/文本字幕，并以整洁的文本形式存储。

• 输入：视频 URL、语言代码
• 输出：公开 URL、文件名、字幕预览

extract_thumbnail_to_cloud

提取视频缩略图并将其存储到云存储中。

• 输入：视频 URL
• 输出：公开 URL、文件名

get_video_metadata

获取全面的视频信息，无需下载。

• 输入：视频 URL
• 输出：标题、上传者、时长、观看次数、描述等

🔧 配置

该服务需要配置兼容 S3 的存储：

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

📁 文件组织

文件会整理到你的 S3 存储桶中：

• videos/ - 下载的视频文件
• audio/ - 提取的音频文件
• transcripts/ - 字幕文本文件
• thumbnails/ - 缩略图

🔒 安全与隐私

• 所有文件都存储在你自己的 S3 存储桶中
• 服务不会永久存储任何数据
• 临时文件会自动清理
• 凭据由 Smithery 安全管理
• 服务在隔离的容器中运行

💰 费用说明

• Smithery 托管：请查看当前定价方案
• Cloudflare R2：存储费用约为 ~$0.015/GB/月，另加带宽费用
• 处理：已包含在 Smithery 托管费用中

🏃‍♂️ 本地开发

如需在本地运行以进行开发：

先决条件

• Node.js 20+
• 已安装 yt-dlp
• S3 凭据

设置

git clone <your-fork>
cd mcp-video-cloud-server
npm install
npm run build:stdio

环境变量

S3_ENDPOINT=your-endpoint
S3_REGION=auto
S3_ACCESS_KEY_ID=your-key
S3_SECRET_ACCESS_KEY=your-secret
S3_BUCKET_NAME=your-bucket

运行

npm run start:stdio

🧪 使用 Smithery 进行测试

使用 Smithery 的开发环境：

npm run dev

这会启动一个开发服务器，并提供 Smithery 操场供测试使用。

🤝 贡献

1. Fork 此仓库
2. 创建功能分支
3. 修改代码
4. 使用 npm run dev 进行测试
5. 提交拉取请求

📄 许可证

MIT 许可证——详情请参阅 LICENSE 文件

🆘 支持

• 部署问题：查看 DEPLOYMENT.md
• Smithery 支持：访问 https://smithery.ai/support
• 错误报告：创建 GitHub issue
• 功能请求：创建 GitHub issue

---

准备好部署了吗？ 👉 按照部署指南操作