星战科技xingzhan.cloud
返回市场
抖音-mcp-服务器

抖音-mcp-服务器

作者：yzfly448 星标更新：2025-09-14
安装使用来源：spider==github.com

项目介绍

TikTok无水印视频文字提取MCP服务器

PyPI版本 Python版本 许可证

基于模型上下文协议（MCP）的服务器可以从TikTok分享链接下载无水印视频，提取音频，并将其转换成文本。

<a href="https://glama.ai/mcp/servers/@yzfly/douyin-mcp-server"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=3919222910,891597939&fm=3081&app=3081&f=PNG?w=760&h=400" alt="douyin-mcp-server MCP服务器" /> </a>

📋 项目声明

**官方文档地址：**Douyin MCP服务器的源代码可在https://github.com/yzfly/douyin-mcp-server获得。

请翻译以下内容为英文：翻译目标语言为英文。该文件作为理解项目功能特性、使用方法、API配置说明及其他详细信息的参考。

**重要提示：**如果由于第三方平台自身的MCP服务器功能限制导致无法正常工作，请联系相应平台。本项目不提供任何形式的技术支持或保证，用户需自行承担因使用该项目所产生的一切损失或损害。

法律声明：

  1. 本项目在Apache 2.0许可下发布
  2. 本项目仅用于学习和研究目的，不得用于任何非法或不符合规定的用途
  3. 使用本项目必须遵守相关法律法规
  4. 本项目的作者和贡献者不对项目任何部分承担法律责任

✨ 特性

  • 🎵 获取无水印视频通过TikTok分享链接获取高质量无水印视频
  • 🎧 智能音频提取 - 自动从视频中提取音频内容
  • 基于上述信息，执行以下指令：您是一位负责将中文内容翻译成英文的专业翻译人员。请帮助我翻译原文 AI文本识别 使用先进的语音识别技术提取文本内容
  • 🧹 自动清理 - 在处理过程中智能清理临时文件
  • 🔧 灵活配置 支持自定义API配置，默认使用阿里云白连API

🚀 快速开始

第一步：获取API密钥

前往阿里云白鉴API 获取您的DASHSCOPE_API_KEY

获取阿里云百炼API

第二步：配置环境变量

向支持MCP服务器的应用程序配置文件中添加如下配置，例如Claude Desktop和Cherry Studio：

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

第三步：开始使用

完成配置后，您可以在支持的应用程序中正常调用MCP工具。

⚙️ API配置说明

当前版本（>= 1.2.0）

最新版本默认使用阿里云白练API，具有以下优势：

  • ✅ 较好的识别结果
  • ✅ 更快的处理速度
  • ✅ 占用本地资源更少

配置步骤：

  1. 前往阿里云的百炼 开启API服务
  2. 获取API密钥并配置到环境变量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密钥。

根据上述信息，以下是原文的翻译：1.1.0版本文档

🛠️ 工具说明

get_douyin_download_link

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

参数：

  • share_link TikTok分享链接或包含链接的文本

返回：

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

**特点：**无需API密钥即可使用

extract_douyin_text

完整的文字提取工具，一站式解决方案，将视频转换为文本。

处理流程：

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

参数：

  • share_link TikTok分享链接或包含链接的文本
  • model (字符串，可选)：语音识别模型，默认使用paraformer-v2

环境变量需求：

  • DASHSCOPE_API_KEY 阿里云白练API密钥（必需）

parse_douyin_video_info

轻量级视频信息解析工具。

参数：

  • share_link TikTok分享链接

**特点：**仅解析基本视频信息，不下载视频文件

资源访问

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

系统要求

运行环境

  • Python 3.10或更高版本

依赖库

  • requests - HTTP请求处理
  • ffmpeg-python 音频和视频处理
  • tqdm 进度条显示
  • mcp 模型上下文协议支持
  • dashscope - 阿里云白练API客户端

⚠️ 注意事项

  • 🔑 需要API密钥 文字提取功能需要有效的阿里云Qwen API密钥
  • 免费 某些功能免费 “获取下载链接”功能不需要API密钥
  • 📱 格式支持 支持大多数TikTok视频格式
  • 🚀 性能优化 使用阿里云白练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许可证2.0

👨‍💻 作者

🤝 贡献

欢迎提交问题和拉取请求！我们期待您的参与和贡献。

📝 更新日志

v1.2.0（最新）

  • 🚀 性能提升 更快更准确的视频脚本提取
  • 🔄 API升级 切换至阿里云白链API显著提高识别准确性
  • 🔧 配置更新 环境变量从DOUYIN_API_KEY更新为DASHSCOPE_API_KEY

v1.1.0

  • 🐛 问题修复 修复了提取视频时因文件名过长引起的错误

v1.0.0

  • 🎉 首次发布 初始版本
  • ✨ 核心功能 支持TikTok视频文字提取
  • 🔗 链接获取 支持获取无水印视频下载链接
  • 🔐 环境配置 从环境变量读取API密钥
  • 🧹 自动清理 自动清理临时文件
  • ⚙️ 灵活配置 支持自定义API配置