Skip to main content
Glama

douyin-mcp-server

by yzfly
MIT License
40
  • Apple
  • Linux

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

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

功能特性

  • 🎵 从抖音分享链接获取无水印视频
  • 🎧 自动提取视频音频
  • 📝 使用AI语音识别提取文本内容
  • 🧹 自动清理中间临时文件
  • 🔧 支持自定义API配置, API 默认使用 SiliconFlow API

安装

使用 uvx 安装(推荐)

uvx douyin-mcp-server

使用 pip 安装

pip install douyin-mcp-server

使用方法

1. 启动服务器

douyin-mcp-server

2. 在Claude Desktop中配置

在你的 claude_desktop_config.json 中添加:

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

3. 使用MCP工具

获取无水印下载链接

使用 get_douyin_download_link 工具:

# 在Claude中使用,无需API密钥 get_douyin_download_link("https://v.douyin.com/xxx")
提取视频文本

使用 extract_douyin_text 工具(需要设置环境变量 DOUYIN_API_KEY):

# 在Claude中使用 extract_douyin_text("https://v.douyin.com/xxx")
解析视频信息

使用 parse_douyin_video_info 工具:

parse_douyin_video_info("https://v.douyin.com/xxx")

API 配置

默认配置

服务器默认使用 SiliconFlow API

  • API URL: https://api.siliconflow.cn/v1/audio/transcriptions
  • 模型: FunAudioLLM/SenseVoiceSmall

自定义配置

你可以自定义API配置:

extract_douyin_text( share_link="your-douyin-link", api_base_url="https://your-custom-api.com/transcriptions", model="your-custom-model" )

环境变量配置

在Claude Desktop的配置文件中设置环境变量:

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

工具说明

获取抖音视频的无水印下载链接,无需API密钥。

参数:

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

返回:

  • 包含下载链接和视频信息的JSON格式数据

extract_douyin_text

完整的文本提取工具,执行以下步骤:

  1. 解析抖音分享链接
  2. 下载无水印视频
  3. 提取音频
  4. 转换音频为文本
  5. 清理临时文件

参数:

  • share_link: 抖音分享链接或包含链接的文本
  • api_base_url: API基础URL(可选)
  • model: 语音识别模型(可选)

环境变量:

  • DOUYIN_API_KEY: 语音识别API密钥(必需)

parse_douyin_video_info

仅解析视频基本信息,不下载视频。

参数:

  • share_link: 抖音分享链接

资源访问

  • douyin://video/{video_id}: 通过视频ID获取详细信息

依赖要求

  • Python 3.8+
  • ffmpeg(系统需要安装ffmpeg)
  • requests
  • ffmpeg-python
  • tqdm
  • mcp

安装 ffmpeg

macOS

brew install ffmpeg

Ubuntu/Debian

sudo apt update sudo apt install ffmpeg

Windows

下载并安装 ffmpeg

开发

本地开发

git clone https://github.com/yzfly/douyin-mcp-server.git cd douyin-mcp-server pip install -e .

运行测试

python -m douyin_mcp_server.server

注意事项

  • 确保系统已安装 ffmpeg
  • 需要在环境变量中设置有效的语音识别API密钥 DOUYIN_API_KEY
  • 获取下载链接功能无需API密钥
  • 中间文件会自动清理,不会占用磁盘空间
  • 支持大部分抖音视频格式

⚠️ 免责声明

  • 使用者对本项目的使用由使用者自行决定,并自行承担风险。作者对使用者使用本项目所产生的任何损失、责任、或风险概不负责。
  • 本项目的作者提供的代码和功能是基于现有知识和技术的开发成果。作者按现有技术水平努力确保代码的正确性和安全性,但不保证代码完全没有错误或缺陷。
  • 本项目依赖的所有第三方库、插件或服务各自遵循其原始开源或商业许可,使用者需自行查阅并遵守相应协议,作者不对第三方组件的稳定性、安全性及合规性承担任何责任。
  • 使用者在使用本项目的代码和功能时,必须自行研究相关法律法规,并确保其使用行为合法合规。任何因违反法律法规而导致的法律责任和风险,均由使用者自行承担。
  • 使用者不得使用本工具从事任何侵犯知识产权的行为,包括但不限于未经授权下载、传播受版权保护的内容,开发者不参与、不支持、不认可任何非法内容的获取或分发。
  • 本项目不对使用者涉及的数据收集、存储、传输等处理活动的合规性承担责任。使用者应自行遵守相关法律法规,确保处理行为合法正当;因违规操作导致的法律责任由使用者自行承担。
  • 使用者在任何情况下均不得将本项目的作者、贡献者或其他相关方与使用者的使用行为联系起来,或要求其对使用者使用本项目所产生的任何损失或损害负责。
  • 基于本项目进行的任何二次开发、修改或编译的程序与原创作者无关,原创作者不承担与二次开发行为或其结果相关的任何责任,使用者应自行对因二次开发可能带来的各种情况负全部责任。
  • 本项目不授予使用者任何专利许可;若使用本项目导致专利纠纷或侵权,使用者自行承担全部风险和责任。未经作者或权利人书面授权,不得使用本项目进行任何商业宣传、推广或再授权。
  • 作者保留随时终止向任何违反本声明的使用者提供服务的权利,并可能要求其销毁已获取的代码及衍生作品。
  • 作者保留在不另行通知的情况下更新本声明的权利,使用者持续使用即视为接受修订后的条款。

在使用本项目的代码和功能之前,请您认真考虑并接受以上免责声明。如果您对上述声明有任何疑问或不同意,请不要使用本项目的代码和功能。如果您使用了本项目的代码和功能,则视为您已完全理解并接受上述免责声明,并自愿承担使用本项目的一切风险和后果。

许可证

MIT License

作者

贡献

欢迎提交 Issue 和 Pull Request!

更新日志

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