抖音-MCP

作者：mj2760975907-ux1 星标更新：2025-11-15

安装使用来源：spider==github.com

项目介绍

抖音发布服务

抖音创作者中心视频自动发布服务支持MCP协议和HTTP API。

项目结构

douyin/
├── lib/                    # 共享业务逻辑模块
│   ├── browser.js         # 浏览器管理（初始化、关闭）
│   ├── utils.js           # 工具函数（调试、元素查找等）
│   └── douyin.js          # 核心业务逻辑（登录、发布等）
│
├── mcp/                   # MCP 服务器（生产环境）
│   └── server.js          # MCP 服务器入口
│
├── dev/                   # HTTP 调试服务器（开发环境）
│   └── server.js          # Express HTTP 服务器
│
├── browser-data/          # 浏览器数据（Cookie 等，自动生成）
├── debug-screenshots/     # 调试截图（开发模式自动生成）
│
├── package.json           # 项目配置
└── README.md              # 项目说明

安装

cd douyin
npm install

使用方法

1. 开发与调试（HTTP 服务器）

npm run dev

启动后访问 http://localhost:3000 提供 HTTP API：

GET /api/health - 健康检查
POST /api/manual-login - 手动登录
GET /api/check-status - 检查登录状态
POST /api/publish - 发布视频

特性：

启用调试模式（自动截图）
详细的控制台日志
方便使用 Postman 和 curl 进行测试

2. 生产环境（MCP 服务器 - STDio）

npm run mcp

适用于 Cherry Studio 和 cursor 等 MCP 客户端。

特性：

通过 STDio 通信
不输出控制台日志（避免干扰 STDio）
适合集成到 AI 工具中

3. MCP HTTP 服务器（流式 HTTP）

npm run mcp:http

使用流式 HTTP 传输协议的 MCP 服务器，支持通过 HTTP 访问。

特性：

基于 HTTP POST/GET/ELETE 请求
支持会话管理
支持 Server Sent Events (SSE) 流式响应
可以直接通过 HTTP 客户端访问
默认端口：3100（可以通过 MCP_HTTP_PORT 环境变量修改）

启动示例：

# 使用默认端口 3100
npm run mcp:http

# 使用自定义端口
MCP_HTTP_PORT=8080 npm run mcp:http

功能

提供三个主要功能：

手动登录 - 打开浏览器并允许用户手动登录并发布作品
检查登录状态 - 检查是否已登录
自动发布视频 - 根据传入的内容自动发布视频

使用流程

首次使用

启动服务：npm run dev 或 npm run mcp
调用手动登录接口/工具
在打开的浏览器中手动登录并发布作品
Cookie 将被自动保存，后续发布可能不需要验证码

后续使用

只需调用发布接口/工具即可。

API 示例（开发模式）

手动登录

curl -X POST http://localhost:3000/api/manual-login

检查登录状态

curl http://localhost:3000/api/check-status

发布视频

curl -X POST http://localhost:3000/api/publish \
  -H "Content-Type: application/json" \
  -d '{
    "title": "我的视频标题",
    "description": "视频简介内容",
    "tags": ["科普", "教育", "儿童"],
    "videoPath": "/Users/mojun/Desktop/video.mp4"
  }'

配置 Cherry Studio

配置步骤

打开 Cherry Studio
点击设置 (Settings)
选择 MCP 服务器 (MCP Servers) 选项
点击 添加服务器 (Add Server) 或 手动添加 (Manual Add)
填写以下信息：
- 服务器名称 (Server Name): douyin-publisher
- 类型 (Type): 选择 STDIO (标准输入/输出)
- 命令 (Command): node
- 参数 (Args): /path/to/douyin/mcp/server.js
或者使用完整路径：
- 命令 (Command): /usr/local/bin/node (或你的 node 路径，可以通过 which node 查看)
- 参数 (Args): /path/to/douyin/mcp/server.js

配置示例

根据 Cherry Studio 的配置格式，可能需要添加：

{
  "mcpServers": {
    "douyin-publisher": {
      "command": "node",
      "args": ["/path/to/douyin/mcp/server.js"]
    }
  }
}

验证连接

配置完成后，在 Cherry Studio 的对话界面中，应该能看到可用的 MCP 工具：

douyin_login - 手动登录
douyin_check_status - 检查登录状态
douyin_publish - 发布视频

使用示例

配置完成后，可以直接在 Cherry Studio 中使用这些工具：

请帮我检查抖音登录状态

或者：

请帮我发布一个视频，标题是"测试视频"，视频路径是 /Users/mojun/Desktop/video.mp4

故障排除

如果工具不可用：

检查路径：确保 mcp/server.js 的路径正确
检查权限：确保文件具有执行权限
检查 Node.js：
- 在终端运行 which node 查看 node 的路径
- 确保系统可以运行 node 命令
查看日志：在 Cherry Studio 日志或开发者工具中查看错误消息

测试 MCP 服务器：

在终端运行：

cd /path/to/douyin
node mcp/server.js

如果服务器正常启动（没有错误或输出），则表示服务器本身没有问题。

配置 MCP HTTP 服务器

使用场景

MCP HTTP 服务器适用于：

需要通过 HTTP 访问 MCP 服务的场景
支持流式 HTTP 传输协议的 MCP 客户端
需要会话管理和状态维护的应用
浏览器或 Web 应用中的 MCP 集成

API 使用示例

1. 初始化会话

请求：

POST http://127.0.0.1:3100/mcp
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "jsonrpc": "2.0",
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": {
      "name": "my-client",
      "version": "1.0.0"
    }
  },
  "id": 1
}

响应：

HTTP/1.1 200 OK
Mcp-Session-Id: 08c36270-b78c-4945-a5de-beda5e21528c
Content-Type: text/event-stream

event: message
data: {"result":{"protocolVersion":"2024-11-05","capabilities":{"tools":{"listChanged":true}},"serverInfo":{"name":"douyin-publisher","version":"1.0.0"}},"jsonrpc":"2.0","id":1}

2. 列出可用工具

POST http://127.0.0.1:3100/mcp
Mcp-Session-Id: 08c36270-b78c-4945-a5de-beda5e21528c
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "params": {},
  "id": 2
}

3. 检查登录状态

POST http://127.0.0.1:3100/mcp
Mcp-Session-Id: 08c36270-b78c-4945-a5de-beda5e21528c
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "douyin_check_status",
    "arguments": {}
  },
  "id": 3
}

4. 发布视频

POST http://127.0.0.1:3100/mcp
Mcp-Session-Id: 08c36270-b78c-4945-a5de-beda5e21528c
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "douyin_publish",
    "arguments": {
      "title": "我的视频标题",
      "videoPath": "/Users/mojun/Desktop/video.mp4",
      "description": "视频简介",
      "tags": ["科普", "教育"]
    }
  },
  "id": 4
}

使用 cURL 测试

# 初始化会话
curl -X POST http://127.0.0.1:3100/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": {"name": "curl-client", "version": "1.0.0"}
    },
    "id": 1
  }'

MCP 可用工具

工具名称	描述	参数
`douyin_login`	手动登录	无
`douyin_check_status`	检查登录状态	无
`douyin_publish`	发布视频	`title`, `videoPath`, `description?`, `tags?`
`douyin_logout`	登出	无

与 STDio 模式差异

特性	STDio 模式	HTTP 模式
传输协议	标准输入/输出	HTTP POST/GET/ELETE
会话管理	单进程	支持多会话
访问方式	进程启动	HTTP 请求
适用场景	AI 工具集成	Web 应用、HTTP 客户端
日志输出	禁用（避免干扰）	启用（便于调试）

注意事项

会话管理：每个客户端需要维护自己的 Mcp-Session-Id
响应格式：服务器可能会返回 SSE 格式或 JSON 格式，客户端需要处理两种情况
安全性：当前版本禁用了 DNS 重绑定保护，仅适用于本地开发
端口冲突：如果端口 3100 被占用，可以使用环境变量 MCP_HTTP_PORT 指定其他端口

故障排除

端口被占用：

✅ 服务器将自动检测并关闭占用端口的老进程
如果自动清理失败，你可以：
- 使用其他端口：MCP_HTTP_PORT=3101 npm run mcp:http
- 手动关闭进程：lsof -i :3100 查看进程，然后 kill <PID>

服务器无法启动：

检查依赖是否安装：npm install
检查 Node.js 版本：node --version（需要 v14+）

连接失败：

确认服务器正在运行
检查防火墙设置
验证 URL 和端口是否正确

会话过期：

服务器重启后，会话将失效
需要重新初始化连接

代码组织

共享模块（`lib/`）

所有业务逻辑都在 lib/ 目录下，MCP 和 HTTP 服务器都使用这些共享模块：

lib/browser.js：浏览器实例管理
lib/utils.js：工具函数（调试、元素查找等）
lib/douyin.js：核心业务逻辑（登录、发布等）

扩展功能

要添加新功能，只需：

在 lib/douyin.js 中添加新的业务功能
在 mcp/server.js 中注册一个新的 MCP 工具
在 dev/server.js 中添加一个新的 HTTP API 端点

示例：添加获取视频列表的功能

// lib/douyin.js
async function getVideoList() {
  // 实现获取视频列表的逻辑
}

// mcp/server.js
mcpServer.registerTool('douyin_get_videos', {...}, async () => {
  const result = await getVideoList();
  // ...
});

// dev/server.js
app.get('/api/videos', async (req, res) => {
  const result = await getVideoList();
  res.json(result);
});

优势

代码复用：业务逻辑只编写一次，MCP 和 HTTP 服务器之间共享
易于调试：开发时使用 HTTP 服务器进行方便的测试和调试
易于扩展：添加新功能只需要修改共享模块
清晰分离：完全分离生产环境（MCP）和开发环境（HTTP）

注意事项

首次登录：必须先使用手动登录功能登录并发布作品，以避免后续验证码
Cookie 持久化：使用 Playwright 的持久上下文，Cookie 将自动保存和恢复
文件路径：videoPath 必须是绝对路径
标签格式：如果标签没有 # 号，将自动添加。标签将逐个添加，每输入一个标签后按回车键将其转换为蓝色并点击标签
浏览器数据：browser-data/ 目录存储浏览器 Cookie，两个服务器之间共享
调试截图：调试截图保存在 debug-screenshots/ 目录中（仅开发模式）

抖音-MCP

项目介绍

抖音发布服务

项目结构

安装

使用方法

1. 开发与调试（HTTP 服务器）

2. 生产环境（MCP 服务器 - STDio）

3. MCP HTTP 服务器（流式 HTTP）

功能

使用流程

首次使用

后续使用

API 示例（开发模式）

手动登录

检查登录状态

发布视频

配置 Cherry Studio

配置步骤

配置示例

验证连接

使用示例

故障排除

配置 MCP HTTP 服务器

使用场景

API 使用示例

1. 初始化会话

2. 列出可用工具

3. 检查登录状态

4. 发布视频

使用 cURL 测试

MCP 可用工具

与 STDio 模式差异

注意事项

故障排除

代码组织

共享模块（lib/）

扩展功能

优势

注意事项

共享模块（`lib/`）