Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Douyin MCPUpload /path/to/video.mp4 with title 'My Daily Vlog' and tags #vlog #lifestyle"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Douyin MCP (Playwright 版)
基于 Playwright 模拟浏览器操作实现的抖音 (Douyin) MCP 服务器，支持视频上传功能。
特性
✅ 扫码登录 - 使用抖音 App 扫码登录
✅ 视频上传 - 模拟浏览器操作上传视频
✅ 自动填表 - 自动填写标题、简介、标签
✅ Cookie 持久化 - 登录状态自动保存
✅ HTTP API - 提供 RESTful API 接口
目录结构
douyin-mcp/
├── server-playwright.js # MCP HTTP 服务器 (端口 18062)
├── login-playwright.js # 扫码登录工具
├── package.json # 依赖配置
├── cookies.json # 登录状态 (自动生成)
└── README.md # 使用文档安装
cd douyin-mcp
npm installPlaywright 浏览器会自动安装。
使用方法
1. 登录抖音
# 在 douyin-mcp 目录
npm run login
# 或
node login-playwright.js运行后会打开浏览器窗口，显示二维码：
打开抖音 App
点击右上角扫描图标
扫描浏览器中的二维码
在手机上确认登录
登录成功后会自动保存 cookies。
2. 启动 MCP 服务器
# 在 douyin-mcp 目录
npm start
# 或
node server-playwright.js服务器运行在 http://localhost:18062
3. 发布视频
使用 curl 调用 API：
curl -X POST http://localhost:18062/api/v1/publish \
-H "Content-Type: application/json" \
-d '{
"title": "视频标题",
"content": "视频简介",
"video_path": "/path/to/video.mp4",
"tags": ["标签 1", "标签 2"],
"visibility": "public"
}'API 接口
健康检查
GET http://localhost:18062/health检查登录状态
GET http://localhost:18062/api/v1/login/status获取登录二维码
GET http://localhost:18062/api/v1/login/qrcode发布视频
POST http://localhost:18062/api/v1/publish
Content-Type: application/json
{
"title": "视频标题",
"content": "视频简介",
"video_path": "/path/to/video.mp4",
"tags": ["标签 1", "标签 2"],
"visibility": "public"
}参数说明：
title- 视频标题content- 视频简介video_path- 本地视频文件绝对路径tags- 标签数组visibility- public(公开) 或 private(私密)
配置 MCP Client
在 MCP 配置中添加：
{
"mcpServers": {
"douyin": {
"command": "node",
"args": ["/path/to/douyin-mcp/server-playwright.js"]
}
}
}常见问题
1. 登录过期
抖音 cookies 有一定的有效期，如果发布时提示未登录，需要重新运行登录工具：
node login-playwright.js2. 浏览器窗口
登录时会显示浏览器窗口（方便扫码）
上传视频时无头模式运行（不显示窗口）
技术栈
Playwright - 浏览器自动化
Express - HTTP 服务器
Node.js - 运行环境
参考
License
MIT
注意
本项目仅供学习和个人使用，请遵守抖音的使用条款和社区规范。