金大哥 - douyin-mcp-server MCP 详情

article

README

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

这是一个基于 Model Context Protocol (MCP) 的服务器，它能够从抖音分享链接下载无水印视频，提取其中的音频，并将其转换为文本，为用户提供便捷的视频内容处理服务。

🚀 快速开始

安装

使用 uvx 安装（推荐）

uvx douyin-mcp-server

使用 pip 安装

pip install douyin-mcp-server

启动服务器

douyin-mcp-server

在Claude Desktop中配置

在你的 claude_desktop_config.json 中添加：

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

✨ 主要特性

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

💻 使用示例

基础用法

获取无水印下载链接

# 在Claude中使用，无需API密钥
get_douyin_download_link("https://v.douyin.com/xxx")

提取视频文本

# 在Claude中使用
extract_douyin_text("https://v.douyin.com/xxx")

解析视频信息

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

📚 详细文档

API 配置

默认配置

服务器API 默认使用阿里云百炼API，你需要前往阿里云百炼开通API服务。

环境变量配置

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

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

工具说明

`get_douyin_download_link`

获取抖音视频的无水印下载链接，无需API密钥。参数：

share_link：抖音分享链接或包含链接的文本返回：
包含下载链接和视频信息的JSON格式数据

`extract_douyin_text`

完整的文本提取工具，执行以下步骤：

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

share_link：抖音分享链接或包含链接的文本
model：语音识别模型（可选，默认使用paraformer-v2） 环境变量：
DASHSCOPE_API_KEY：阿里云百炼API密钥（必需）

`parse_douyin_video_info`

仅解析视频基本信息，不下载视频。参数：

share_link：抖音分享链接

资源访问

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

依赖要求

Python 3.10+
requests
ffmpeg-python
tqdm
mcp
dashscope

开发

本地开发

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"
      }
    }
  }
}

注意事项

⚠️ 重要提示

切换到使用阿里云百炼API进行语音识别，更快更准

需要在环境变量中设置有效的阿里云百炼API密钥 DASHSCOPE_API_KEY

获取下载链接功能无需API密钥

支持大部分抖音视频格式

⚠️ 免责声明

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

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

📄 许可证

MIT License

作者

yzfly - yz.liu.me@gmail.com
GitHub: https://github.com/yzfly

贡献

欢迎提交 Issue 和 Pull Request！

更新日志

v1.0.0

初始版本
支持抖音视频文本提取
支持获取无水印视频下载链接
从环境变量读取API密钥
自动清理临时文件
支持自定义API配置

v1.1.0

修复提取视频时文件名过长的bug

v1.2.0

更快、更准的视频文案提取
切换到阿里云百炼API，提升识别准确率
更新环境变量从DOUYIN_API_KEY到DASHSCOPE_API_KEY