Extracts audio from downloaded Douyin videos, enabling the conversion of video content to audio format for text transcription.
Supports repository access for development and contribution purposes, allowing users to clone the source code and submit issues or pull requests.
抖音无水印视频文本提取 MCP 服务器
一个基于 Model Context Protocol (MCP) 的服务器,可以从抖音分享链接下载无水印视频,提取音频并转换为文本。
📋 项目声明
官方文档地址: https://github.com/yzfly/douyin-mcp-server
请以本项目的 README.md 文件为准,了解项目的功能特性、使用方法、API 配置说明等详细信息。
重要提醒: 第三方平台如因自身 MCP Server 功能支持度限制而无法正常使用,请联系相应平台方。本项目不提供任何形式的技术支持或保证,用户需自行承担使用本项目可能产生的任何损失或损害。
法律声明:
- 本项目基于 Apache 2.0 协议发布
- 本项目仅供学习和研究使用,不得用于任何违法或违规目的
- 本项目的使用必须遵守相关法律法规
- 本项目的作者和贡献者不对项目的任何部分承担法律责任
✨ 功能特性
- 🎵 无水印视频获取 - 从抖音分享链接获取高质量无水印视频
- 🎧 智能音频提取 - 自动从视频中提取音频内容
- 📝 AI 文本识别 - 使用先进的语音识别技术提取文本内容
- 🧹 自动清理 - 智能清理处理过程中的临时文件
- 🔧 灵活配置 - 支持自定义 API 配置,默认使用 阿里云百炼 API
🚀 快速开始
步骤 1:获取 API 密钥
前往 阿里云百炼 API 获取您的 DASHSCOPE_API_KEY
:
步骤 2:配置环境变量
在 Claude Desktop、Cherry Studio 等支持 MCP Server 的应用配置文件中添加以下配置:
步骤 3:开始使用
配置完成后,您就可以在支持的应用中正常调用 MCP 工具了。
⚙️ API 配置说明
当前版本(>= 1.2.0)
最新版本默认使用阿里云百炼 API,具有以下优势:
- ✅ 识别效果更好
- ✅ 处理速度更快
- ✅ 本地资源消耗更小
配置步骤:
- 前往 阿里云百炼 开通 API 服务
- 获取 API Key 并配置到环境变量
DASHSCOPE_API_KEY
中
旧版本兼容(<= 1.1.0)
如果您需要使用旧版本,请使用以下配置:
注意: 旧版本使用硅基流动 API,需要在 硅基流动 注册账号并获取 API Key。
🛠️ 工具说明
get_douyin_download_link
获取抖音视频的无水印下载链接。
参数:
share_link
(string): 抖音分享链接或包含链接的文本
返回:
- JSON 格式的下载链接和视频信息
特点: 无需 API 密钥即可使用
extract_douyin_text
完整的文本提取工具,一站式完成视频到文本的转换。
处理流程:
- 解析抖音分享链接
- 直接使用视频 URL 进行语音识别
- 返回提取的文本内容
参数:
share_link
(string): 抖音分享链接或包含链接的文本model
(string, 可选): 语音识别模型,默认使用paraformer-v2
环境变量要求:
DASHSCOPE_API_KEY
: 阿里云百炼 API 密钥(必需)
parse_douyin_video_info
轻量级视频信息解析工具。
参数:
share_link
(string): 抖音分享链接
特点: 仅解析视频基本信息,不下载视频文件
资源访问
douyin://video/{video_id}
: 通过视频 ID 获取详细信息
📦 系统要求
运行环境
- Python: 3.10 或更高版本
依赖库
requests
- HTTP 请求处理ffmpeg-python
- 音视频处理tqdm
- 进度条显示mcp
- Model Context Protocol 支持dashscope
- 阿里云百炼 API 客户端
⚠️ 注意事项
- 🔑 API 密钥必需:文本提取功能需要有效的阿里云百炼 API 密钥
- 🆓 部分功能免费:获取下载链接功能无需 API 密钥
- 📱 格式支持:支持大部分抖音视频格式
- 🚀 性能优化:使用阿里云百炼 API 获得更快更准确的识别效果
🔧 开发指南
本地开发环境搭建
运行测试
Claude Desktop 本地开发配置
在 Claude Desktop 配置文件中添加本地开发配置:
⚠️ 免责声明
使用风险
- 使用者对本项目的使用完全自主决定,并自行承担所有风险
- 作者对使用者因使用本项目而产生的任何损失、责任或风险概不负责
代码质量
- 本项目基于现有知识和技术开发,作者努力确保代码的正确性和安全性
- 但不保证代码完全没有错误或缺陷,使用者需自行评估和测试
第三方依赖
- 本项目依赖的第三方库、插件或服务遵循各自的开源或商业许可
- 使用者需自行查阅并遵守相应协议
- 作者不对第三方组件的稳定性、安全性及合规性承担责任
法律合规
- 使用者必须自行研究相关法律法规,确保使用行为合法合规
- 任何违反法律法规导致的法律责任和风险,均由使用者自行承担
- 禁止使用本工具从事任何侵犯知识产权的行为
- 开发者不参与、不支持、不认可任何非法内容的获取或分发
数据处理
- 本项目不对使用者的数据收集、存储、传输等处理活动的合规性承担责任
- 使用者应自行遵守相关法律法规,确保数据处理行为合法正当
责任限制
- 使用者不得将项目作者、贡献者或相关方与使用行为联系起来
- 不得要求作者对使用项目产生的任何损失或损害负责
- 基于本项目的二次开发、修改或编译程序与原作者无关
知识产权
- 本项目不授予使用者任何专利许可
- 若使用本项目导致专利纠纷或侵权,使用者自行承担全部风险和责任
- 未经书面授权,不得用于商业宣传、推广或再授权
服务终止
- 作者保留随时终止向违反声明的使用者提供服务的权利
- 可能要求违规使用者销毁已获取的代码及衍生作品
- 作者保留在不另行通知的情况下更新本声明的权利
⚠️ 重要提醒:在使用本项目前,请认真阅读并完全理解上述免责声明。如有疑问或不同意任何条款,请勿使用本项目。继续使用即视为完全接受上述声明并自愿承担所有风险和后果。
📄 许可证
Apache License 2.0
👨💻 作者
- yzfly - yz.liu.me@gmail.com
- GitHub: https://github.com/yzfly
🤝 贡献
欢迎提交 Issue 和 Pull Request!我们期待您的参与和贡献。
📝 更新日志
v1.2.0 (最新)
- 🚀 性能提升:更快、更准确的视频文案提取
- 🔄 API 升级:切换到阿里云百炼 API,显著提升识别准确率
- 🔧 配置更新:环境变量从
DOUYIN_API_KEY
更新为DASHSCOPE_API_KEY
v1.1.0
- 🐛 问题修复:修复提取视频时文件名过长导致的错误
v1.0.0
- 🎉 首次发布:初始版本
- ✨ 核心功能:支持抖音视频文本提取
- 🔗 链接获取:支持获取无水印视频下载链接
- 🔐 环境配置:从环境变量读取 API 密钥
- 🧹 自动清理:自动清理临时文件
- ⚙️ 灵活配置:支持自定义 API 配置
Related MCP Servers
- MIT License
- PythonMIT License
- JavaScriptApache 2.0
- Apache 2.0