douyin-mcp-server

在日常工作和学习中，我们经常会遇到需要保存或分析抖音视频内容的情况——也许是收集灵感素材，也许是提取文案进行分析，又或者是想要保存无水印的原视频用于二次创作。传统的方式往往需要打开手机、复制链接、粘贴到某个解析网站、等待下载……步骤繁琐且容易中断思路。douyin-mcp-server 的出现彻底改变了这一切，它让 AI 助手（如 Claude、Cursor）能够直接帮你完成抖音视频的解析、下载和文案提取，你只需要一句话的指令。

项目基本信息

一、项目介绍

douyin-mcp-server 是一个基于模型上下文协议（MCP）的服务器，专为抖音视频处理而设计。它像一座桥梁，将 AI 助手与抖音视频的解析、下载、文案提取能力连接起来。

核心功能模块

该项目提供了三个核心 MCP 工具，覆盖了从信息获取到内容处理的完整流程：

1. 解析视频信息 (parse_douyin_video_info)：输入抖音分享链接，快速获取视频的基本元数据，包括视频标题、作者信息、封面图链接等。这个工具不会下载视频，适合轻量级的信息查询。
2. 获取无水印下载链接 (get_douyin_download_link)：这是最核心的功能。它能解析抖音分享链接，返回无水印视频的直接下载地址，无需任何 API 密钥即可使用。
3. 提取视频文本 (extract_douyin_text)：这是一个高级功能，执行完整的处理流程：解析链接 → 下载无水印视频 → 提取音频 → 调用 AI 语音识别将音频转为文本 → 清理临时文件。此功能需要配置语音识别 API 密钥（默认使用 SiliconFlow API）。

技术实现

项目使用 Python 3.8+ 开发，核心依赖包括 ffmpeg（音视频处理）、requests（网络请求）、ffmpeg-python 和 mcp 协议库。所有处理都在本地完成，中间文件会自动清理，不会占用磁盘空间。

二、核心优势

无水印解析能力

这是 douyin-mcp-server 最显著的优势。它能精准解析抖音的短链接（如 https://v.douyin.com/xxx），提取出无平台水印的原始视频地址。对于需要收集素材或进行二次创作的用户来说，这省去了寻找第三方解析工具的麻烦。

与 AI 工作流深度集成

项目完全遵循 MCP 标准，可以无缝接入 Claude Desktop、Cursor、VS Code 等主流 AI 客户端。配置完成后，你只需要在对话中用自然语言说“帮我下载这个抖音视频”，AI 就会自动调用相应工具完成操作，无需离开当前的编程或写作环境。

语音转文本扩展能力

通过集成 AI 语音识别服务，douyin-mcp-server 不仅能获取视频本身，还能将视频中的口播内容转换为文本。这为内容分析、文案提取、字幕制作等场景提供了极大的便利。默认使用的 SiliconFlow API 提供了一定的免费额度，你也可以配置其他兼容 OpenAI 格式的 API 端点。

轻量且跨平台

项目以 Python 包的形式发布，通过 pip 或 uvx 即可安装，支持 Windows、macOS 和 Linux。代码结构清晰，依赖明确，便于二次开发和定制。

三、适用场景

素材收集与灵感整理

作为内容创作者或设计师，你可以让 AI 助手批量解析抖音链接，提取无水印视频保存到本地素材库，同时获取视频标题和作者信息用于归档。

文案分析与学习

通过语音转文本功能，你可以将热门视频的口播文案提取出来，用于学习表达技巧、分析内容结构，或作为写作参考。

自动化内容聚合

结合其他 MCP 工具（如文件系统操作、数据库写入），你可以构建一个自动化的内容聚合流程：AI 获取抖音链接列表，依次提取视频信息和文案，然后保存为结构化的文档或录入数据库。

二次创作辅助

对于视频剪辑者，douyin-mcp-server 可以快速获取无水印素材和原始文案，大幅提升二创的前期准备效率。

四、安装教程

环境要求

FFmpeg 安装

macOS

brew install ffmpeg

Ubuntu/Debian

sudo apt update
sudo apt install ffmpeg

Windows
访问 FFmpeg 官网 下载 Windows 版本，解压后将 bin 目录添加到系统 PATH 环境变量。

安装 douyin-mcp-server

方式一：使用 uvx 安装（推荐）

uvx douyin-mcp-server

方式二：使用 pip 安装

pip install douyin-mcp-server

在 Claude Desktop 中配置

打开 Claude Desktop 的配置文件（位置见下方），添加以下配置块：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

注意：

• 如果只使用获取下载链接和解析信息功能，无需配置 DOUYIN_API_KEY。
• 如果需要使用语音转文本功能，请注册 SiliconFlow（或其他兼容 API）获取密钥并填入。

保存配置后，完全退出并重启 Claude Desktop 即可生效。

五、使用示例

配置完成后，你可以在 Claude Desktop 中用自然语言指挥 AI 完成抖音视频处理。

示例一：获取视频基本信息

用户：帮我看看这个抖音视频的信息：https://v.douyin.com/xxxxx

AI 会调用 parse_douyin_video_info 工具，返回视频标题、作者、封面等元数据。

示例二：获取无水印下载链接

用户：把这个抖音视频的无水印链接给我：https://v.douyin.com/xxxxx

AI 调用 get_douyin_download_link 工具，返回可以直接下载的无水印视频 URL。

示例三：提取视频文案

用户：帮我提取这个抖音视频的文案：https://v.douyin.com/xxxxx

AI 调用 extract_douyin_text 工具，执行完整的下载、音频提取、语音转文本流程，最终返回视频中的口播文字内容。

示例四：批量处理（结合其他工具）

用户：这是三个抖音链接，帮我依次提取它们的文案，并保存到一个 markdown 文件中。

AI 会逐条调用 extract_douyin_text，然后使用文件系统 MCP 工具将结果写入文档。

六、常见问题

问：提示“FFmpeg not found”错误怎么办？

答：这表示系统未安装 FFmpeg 或未添加到 PATH 环境变量。请按照第四节的指引安装 FFmpeg，并确保在终端中运行 ffmpeg -version 能正常显示版本信息。

问：获取下载链接功能需要 API 密钥吗？

答：不需要。get_douyin_download_link 和 parse_douyin_video_info 是无需任何 API 密钥即可使用的。只有 extract_douyin_text 语音转文本功能需要配置 DOUYIN_API_KEY。

问：语音转文本功能使用的是什么 API？如何获取？

答：默认使用 SiliconFlow API，模型为 FunAudioLLM/SenseVoiceSmall。你可以访问 SiliconFlow 官网 注册账号获取 API 密钥，新用户通常有一定免费额度。如果需要使用其他兼容 OpenAI 格式的 API，可以通过 api_base_url 和 model 参数自定义。

问：某些抖音链接解析失败怎么办？

答：请确保使用的是标准的抖音分享短链接（格式为 https://v.douyin.com/xxxxx）。如果链接来自浏览器地址栏的长链接，尝试使用分享功能生成短链接后再试。另外，抖音平台偶尔会更新接口，如果问题持续，可以关注项目 GitHub 仓库的最新更新。

问：下载的视频保存在哪里？

答：默认保存在项目工作目录下，文件命名格式为 {videoId}.mp4。你可以通过设置环境变量 WORK_DIR 自定义保存路径。

七、总结

douyin-mcp-server 是一个将抖音视频处理能力融入 AI 工作流的典范之作。它小巧、专注、实用，通过 MCP 协议将原本需要多步手动操作的任务简化为一句话的指令。无论是内容创作者收集素材、运营人员分析文案，还是开发者构建自动化流程，它都能带来显著的效率提升。

项目完全开源（Apache 2.0 协议），代码结构清晰，依赖明确，也为想要学习 MCP 服务器开发或进行二次定制的开发者提供了优秀的参考范例。如果你日常工作中涉及抖音内容的处理，douyin-mcp-server 绝对值得加入你的 MCP 工具箱。