Skip to main content
Glama

douyin-mcp-server

by yzfly

抖音无水印视频文本提取 MCP 服务器

一个基于 Model Context Protocol (MCP) 的服务器,可以从抖音分享链接下载无水印视频,提取音频并转换为文本。

📋 项目声明

官方文档地址: https://github.com/yzfly/douyin-mcp-server

请以本项目的 README.md 文件为准,了解项目的功能特性、使用方法、API 配置说明等详细信息。

重要提醒: 第三方平台如因自身 MCP Server 功能支持度限制而无法正常使用,请联系相应平台方。本项目不提供任何形式的技术支持或保证,用户需自行承担使用本项目可能产生的任何损失或损害。

法律声明:

  1. 本项目基于 Apache 2.0 协议发布
  2. 本项目仅供学习和研究使用,不得用于任何违法或违规目的
  3. 本项目的使用必须遵守相关法律法规
  4. 本项目的作者和贡献者不对项目的任何部分承担法律责任

✨ 功能特性

  • 🎵 无水印视频获取 - 从抖音分享链接获取高质量无水印视频
  • 🎧 智能音频提取 - 自动从视频中提取音频内容
  • 📝 AI 文本识别 - 使用先进的语音识别技术提取文本内容
  • 🧹 自动清理 - 智能清理处理过程中的临时文件
  • 🔧 灵活配置 - 支持自定义 API 配置,默认使用 阿里云百炼 API

🚀 快速开始

步骤 1:获取 API 密钥

前往 阿里云百炼 API 获取您的 DASHSCOPE_API_KEY

获取阿里云百炼API

步骤 2:配置环境变量

在 Claude Desktop、Cherry Studio 等支持 MCP Server 的应用配置文件中添加以下配置:

{ "mcpServers": { "douyin-mcp": { "command": "uvx", "args": ["douyin-mcp-server"], "env": { "DASHSCOPE_API_KEY": "sk-xxxx" } } } }

步骤 3:开始使用

配置完成后,您就可以在支持的应用中正常调用 MCP 工具了。

⚙️ API 配置说明

当前版本(>= 1.2.0)

最新版本默认使用阿里云百炼 API,具有以下优势:

  • ✅ 识别效果更好
  • ✅ 处理速度更快
  • ✅ 本地资源消耗更小

配置步骤:

  1. 前往 阿里云百炼 开通 API 服务
  2. 获取 API Key 并配置到环境变量 DASHSCOPE_API_KEY

旧版本兼容(<= 1.1.0)

如果您需要使用旧版本,请使用以下配置:

{ "mcpServers": { "douyin-mcp": { "command": "uvx", "args": ["douyin-mcp-server@1.1.0"], "env": { "DOUYIN_API_KEY": "your-api-key-here" } } } }

注意: 旧版本使用硅基流动 API,需要在 硅基流动 注册账号并获取 API Key。

📖 1.1.0 版本文档

🛠️ 工具说明

获取抖音视频的无水印下载链接。

参数:

  • share_link (string): 抖音分享链接或包含链接的文本

返回:

  • JSON 格式的下载链接和视频信息

特点: 无需 API 密钥即可使用

extract_douyin_text

完整的文本提取工具,一站式完成视频到文本的转换。

处理流程:

  1. 解析抖音分享链接
  2. 直接使用视频 URL 进行语音识别
  3. 返回提取的文本内容

参数:

  • 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 获得更快更准确的识别效果

🔧 开发指南

本地开发环境搭建

# 克隆项目 git clone https://github.com/yzfly/douyin-mcp-server.git cd douyin-mcp-server # 安装依赖(开发模式) pip install -e .

运行测试

# 启动服务器进行测试 python -m douyin_mcp_server.server

Claude Desktop 本地开发配置

在 Claude Desktop 配置文件中添加本地开发配置:

{ "mcpServers": { "douyin-mcp": { "command": "uv", "args": [ "run", "--directory", "/path/to/your/douyin-mcp-server", "python", "-m", "douyin_mcp_server" ], "env": { "DASHSCOPE_API_KEY": "your-api-key-here" } } } }

⚠️ 免责声明

使用风险

  • 使用者对本项目的使用完全自主决定,并自行承担所有风险
  • 作者对使用者因使用本项目而产生的任何损失、责任或风险概不负责

代码质量

  • 本项目基于现有知识和技术开发,作者努力确保代码的正确性和安全性
  • 但不保证代码完全没有错误或缺陷,使用者需自行评估和测试

第三方依赖

  • 本项目依赖的第三方库、插件或服务遵循各自的开源或商业许可
  • 使用者需自行查阅并遵守相应协议
  • 作者不对第三方组件的稳定性、安全性及合规性承担责任

法律合规

  • 使用者必须自行研究相关法律法规,确保使用行为合法合规
  • 任何违反法律法规导致的法律责任和风险,均由使用者自行承担
  • 禁止使用本工具从事任何侵犯知识产权的行为
  • 开发者不参与、不支持、不认可任何非法内容的获取或分发

数据处理

  • 本项目不对使用者的数据收集、存储、传输等处理活动的合规性承担责任
  • 使用者应自行遵守相关法律法规,确保数据处理行为合法正当

责任限制

  • 使用者不得将项目作者、贡献者或相关方与使用行为联系起来
  • 不得要求作者对使用项目产生的任何损失或损害负责
  • 基于本项目的二次开发、修改或编译程序与原作者无关

知识产权

  • 本项目不授予使用者任何专利许可
  • 若使用本项目导致专利纠纷或侵权,使用者自行承担全部风险和责任
  • 未经书面授权,不得用于商业宣传、推广或再授权

服务终止

  • 作者保留随时终止向违反声明的使用者提供服务的权利
  • 可能要求违规使用者销毁已获取的代码及衍生作品
  • 作者保留在不另行通知的情况下更新本声明的权利

⚠️ 重要提醒:在使用本项目前,请认真阅读并完全理解上述免责声明。如有疑问或不同意任何条款,请勿使用本项目。继续使用即视为完全接受上述声明并自愿承担所有风险和后果。

📄 许可证

Apache License 2.0

👨‍💻 作者

🤝 贡献

欢迎提交 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

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yzfly/douyin-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server