MCP Video Download URL Parser

这是一个基于MCP的视频下载工具，支持从抖音、TikTok等平台下载无水印视频。

功能特点

• 支持从抖音、TikTok、哔哩哔哩等平台下载无水印视频
• 使用Playwright模拟浏览器环境，绕过网站的防爬措施
• 自动提取视频标题和下载链接
• 支持自定义下载路径
• 支持作为MCP服务运行

安装依赖

# 安装Python依赖
uv pip install -r requirements.txt

# 安装Playwright浏览器
playwright install

使用方法

作为MCP服务运行

uv run --index-url https://mirrors.aliyun.com/pypi/simple/ main.py

然后可以通过MCP调用download_video函数：

# MCP调用示例
result = await mcp_video_url_parser_download_video(url="https://v.douyin.com/your_video_id/", output_path="D:\\视频")

直接使用测试脚本

# 使用默认测试URL
uv run direct_test.py

# 指定视频URL
uv run direct_test.py "https://v.douyin.com/your_video_id/"

技术实现

本工具使用了两种方式来提取视频URL：

1. Playwright模拟浏览器（主要方法）：

   • 完全模拟真实浏览器环境
   • 自动访问snapany.com网站
   • 输入视频链接并点击提取按钮
   • 监听API响应或直接从页面提取视频元素
   • 绕过网站的防爬措施，如请求头验证、Cookie验证等

2. API直接请求（备用方法）：

   • 直接向snapany.com的API发送请求
   • 添加必要的请求头和参数
   • 处理多种可能的响应格式

防爬措施解决方案

snapany.com网站有严格的防爬措施，包括：

1. 请求头验证：需要特定的请求头，如g-timestamp和g-footer
2. Cookie验证：需要有效的会话Cookie
3. 浏览器指纹：检查浏览器环境、Canvas指纹等
4. 动态签名生成：可能基于多种因素动态生成签名

我们通过使用Playwright完全模拟浏览器环境，成功绕过了这些防爬措施。Playwright提供了真实的浏览器环境，包括JavaScript执行、Cookie管理和请求拦截等功能，使我们能够像真实用户一样与网站交互。

注意事项

• 本工具仅用于学习和研究目的
• 请遵守相关平台的使用条款和版权规定
• 不要过于频繁地使用，以避免对目标网站造成压力

安装和执行

通过Smithery安装

要通过Smithery为Claude Desktop自动安装MCP Video Download URL Parser：

npx -y @smithery/cli install @tansunyj/mcp_video_download_url_parser --client claude

手动安装

1. 克隆仓库：git clone https://github.com/tansunyj/mcp_video_download_url_parser.git
2. 进入目录：cd mcp_video_download_url_parser
3. 安装依赖：pip install -r requirements.txt
4. 启动MCP服务器：python main.py

配置Claude Desktop或Cursor

1. 添加以下配置：

{
    "mcpServers": {
        "video-url-parser": {
            "command": "python",
            "args": [
                "/path/to/mcp_video_download_url_parser/main.py"
            ],
            "env": {}
        }
    }
}

在魔塔社区(Cursor)部署配置

要在魔塔社区上部署此MCP服务，请按照以下步骤操作：

1. 上传项目：将项目上传到魔塔社区平台

2. 配置服务：在魔塔社区控制台中，找到"MCP服务配置"部分，添加以下配置信息：

{
  "name": "video-url-parser",
  "description": "视频下载解析工具",
  "version": "1.0.0",
  "main": "main.py",
  "requirements": ["playwright", "asyncio", "aiohttp", "beautifulsoup4"],
  "environmentVariables": {
    "DOWNLOAD_PATH": "./downloads"
  }
}

3. 开启服务：在魔塔社区控制台中，找到已添加的服务，点击"开启服务"按钮

4. 服务调用：在魔塔社区中，可以通过以下方式调用该服务：

# 调用示例
result = await mcp_video_url_parser_download_video(
    url="https://v.douyin.com/your_video_id/", 
    output_path="指定保存路径"
)

5. 常见问题排查：
   • 确保所有依赖项都已正确安装
   • 检查环境变量是否正确配置
   • 若出现网络问题，请确认服务器能够访问视频平台网站
   • 若服务无法启动，检查日志获取详细错误信息

使用示例

配置完成后，可以使用如下提示：

• "下载这个视频：[video_url]"
• "将这个视频保存到D:/videos目录：[video_url]"

环境变量

• DOWNLOAD_PATH：保存下载视频的路径（默认：./downloads）

开发

要参与开发：

git clone https://github.com/tansunyj/mcp_video_download_url_parser.git
cd mcp_video_download_url_parser
python -m pytest tests/

安全性

此MCP服务器在您的本地机器上运行。虽然它不执行任意代码，但在解析来自不受信任来源的URL时请小心。

致谢

本项目使用SnapAny.com的API进行视频解析和下载。

许可证

MIT许可证

---