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

v1.0.0

Published

a month ago

抖音视频解析与下载工具，支持 MCP 协议

Downloads

0High
0Medium
0Low

joydragon

mcp douyin tiktok video download ai automation

抖音 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 - 下载的视频文件
（你可以用工具返回值直接获取这些文件名）

使用流程示例

获取下载链接 使用 get_douyin_download_link 工具获取无水印视频链接
下载视频文件 用 download_douyin_video 工具直接下载视频文件
查看视频信息 用 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     # 下载的视频文件

自定义扩展

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

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

技术栈

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

故障排除

常见问题

视频下载失败

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

工作目录权限问题

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

链接解析失败

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

日志调试

启用详细日志：

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

贡献指南

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

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

开发规范

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

许可证

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

作者信息

作者: Yuchen Wang
邮箱: [email protected]
GitHub: https://github.com/yc-w-cn

更新日志

v1.0.0 (2025-01-15)

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

支持

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

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

📧 邮箱：[email protected]
🐛 GitHub Issues：项目问题追踪
💬 GitHub Discussions：项目讨论区