douyin-mcp-server

yc-w-cn/douyin-mcp-server

3.3

If you are the rightful owner of douyin-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

A TikTok video parsing and downloading tool based on the Model Context Protocol (MCP) standard, offering features like link parsing and watermark-free video downloads.

Tools
3
Resources
0
Prompts
0

抖音 MCP Server

一个基于抖音的视频解析与下载工具。支持 Model Context Protocol (MCP) 标准，提供抖音视频链接解析、无水印视频下载功能，适合自用或自动化工具集成。

功能亮点

  • 🔍 抖音链接智能解析：自动识别分享链接，提取无水印视频地址
  • 📥 一键下载视频：直接下载无水印视频文件到本地
  • 📊 实时进度显示：控制台显示下载进度，清晰了解下载状态
  • 🗑️ 自动文件管理：文件保存在指定工作目录，便于管理

每个工具都会返回实际保存的文件名和视频信息，方便你集成到任何自动化流程！

安装使用

NPX 方式（推荐）

pnpx @yc-w-cn/douyin-mcp-server

全局安装

pnpm install -g @yc-w-cn/douyin-mcp-server
douyin-mcp-server

配置要求

环境变量

在使用前，可以设置工作目录环境变量（可选）：

# 可选：自定义工作目录
export WORK_DIR="/path/to/your/data/directory"

或者使用默认工作目录 .data（无需设置环境变量）

MCP 客户端配置

Claude Desktop 配置

在 Claude Desktop 的配置文件中添加：

{
  "mcpServers": {
    "douyin-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yc-w-cn/douyin-mcp-server@latest"],
      "env": {
        "WORK_DIR": "/path/to/your/data/directory"
      }
    }
  }
}

配置文件位置：

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

其他 MCP 客户端

对于其他支持 MCP 的客户端，请参考其文档配置 stdio 传输方式。

可用工具与参数

每个工具处理后都会返回视频信息和保存的文件名，便于后续追踪或下载。

1. 获取无水印下载链接

  • 工具名: get_douyin_download_link
  • 参数:
    • share_link：抖音分享链接或包含链接的文本

2. 下载视频文件

  • 工具名: download_douyin_video
  • 参数:
    • share_link：抖音分享链接或包含链接的文本

3. 解析视频信息

  • 工具名: parse_douyin_video_info
  • 参数:
    • share_link：抖音分享链接或包含链接的文本

文件输出规范

所有生成文件均保存至工作目录，文件名规则如下：

  • {videoId}.mp4 - 下载的视频文件
  • （你可以用工具返回值直接获取这些文件名）

使用流程示例

  1. 获取下载链接 使用 get_douyin_download_link 工具获取无水印视频链接
  2. 下载视频文件 用 download_douyin_video 工具直接下载视频文件
  3. 查看视频信息 用 parse_douyin_video_info 工具查看视频基本信息

开发指南

本地开发

# 克隆项目
git clone https://github.com/yc-w-cn/douyin-mcp-server.git
cd douyin-mcp-server

# 安装依赖
pnpm install

# 开发模式运行
pnpm run dev

# 构建
pnpm run build

# 运行构建版本
pnpm start

项目结构

douyin-mcp-server/
├── src/                  # 源代码目录
│   ├── config/           # 配置文件
│   ├── services/         # 服务层
│   ├── tools/            # 工具定义
│   └── utils/            # 工具函数
├── dist/                 # 编译输出目录
├── package.json          # 项目配置
├── tsconfig.json         # TypeScript 配置
├── README.md             # 项目说明
└── .data/                # 默认工作目录
    └── {videoId}.mp4     # 下载的视频文件

自定义扩展

您可以根据需要扩展以下功能：

  1. 批量处理：支持批量处理多个抖音链接
  2. 视频格式转换：支持转换为其他视频格式
  3. 音频提取：从视频中提取音频文件
  4. 缓存机制：添加智能缓存以提高性能

技术栈

  • Node.js >= 18.0.0
  • TypeScript - 类型安全的JavaScript
  • Model Context Protocol - 标准化的AI上下文协议
  • Axios - HTTP 请求库
  • Zod - 数据验证库

故障排除

常见问题

  1. 视频下载失败

    错误：下载失败: Request failed with status code 404
解决：检查抖音链接是否正确，确保网络连接正常

  2. 工作目录权限问题

    错误：EACCES: permission denied
解决：确保工作目录有写入权限，或设置 WORK_DIR 到有权限的目录

  3. 链接解析失败

    错误：未找到有效的分享链接
解决：检查分享链接格式是否正确，确保链接未过期

日志调试

启用详细日志：

DEBUG=douyin-mcp-server pnpx @yc-w-cn/douyin-mcp-server

贡献指南

欢迎贡献代码！请遵循以下步骤：

  1. Fork 本项目
  2. 创建特性分支：git checkout -b feature/amazing-feature
  3. 提交更改：git commit -m 'Add amazing feature'
  4. 推送分支：git push origin feature/amazing-feature
  5. 创建 Pull Request

开发规范

  • 使用 TypeScript 进行类型安全开发
  • 遵循 ESLint 代码规范
  • 添加适当的错误处理
  • 编写清晰的注释和文档

许可证

本项目采用 MIT 许可证。详情请见 文件。

作者信息

更新日志

v1.0.0 (2025-01-15)

  • ✨ 初始版本发布
  • 🔍 支持抖音链接解析
  • 📥 支持无水印视频下载
  • 📊 支持实时下载进度显示
  • � 支持视频信息获取

相关链接

支持

如果您觉得这个项目有用，请给它一个 ⭐！

如有问题或建议，请通过以下方式联系：