TikTok MCP 服务
用于 TikTok 视频发现和元数据提取的模型上下文协议服务。该服务提供了一个强大的界面，可通过主题标签搜索 TikTok 视频并检索热门内容，并内置了反检测措施和错误处理功能。
特征
- 按主题标签搜索视频
- 可配置每次搜索的视频数量（默认值：30）
- 反机器人检测措施
- 代理支持
- 自动 API 会话管理
- 速率限制和错误处理
- 健康状态监测
配置
该服务使用环境变量进行配置。创建一个.env文件，其中包含以下内容：
ms_token=your_tiktok_ms_token # Optional but recommended to avoid bot detection
TIKTOK_PROXY=your_proxy_url # Optional proxy configuration
安装和设置
# Install dependencies
poetry install
# Install browser automation dependencies
poetry run python -m playwright install
# Start the service
poetry run python -m tiktok_mcp_service.main
Claude 桌面集成
服务运行后，即可将其与 Claude Desktop 集成。由于我们使用 Poetry 进行依赖管理，请确保通过 Poetry 运行 MCP CLI 命令：
# Navigate to the project directory
cd /path/to/tiktok-mcp-service
# Install the service in Claude Desktop with Poetry in editable mode
poetry run mcp install tiktok_mcp_service/main.py --with-editable . -f .env
# Optional: Install with a custom name
poetry run mcp install tiktok_mcp_service/main.py --name "TikTok Video Search" --with-editable . -f .env
安装后，该服务将在 Claude Desktop 中可用，并将使用 Poetry 运行以进行适当的依赖关系管理。
API 端点
健康检查
GET /health - 检查服务健康状况和 API 初始化状态{
"status": "running",
"api_initialized": true,
"service": {
"name": "TikTok MCP Service",
"version": "0.1.0",
"description": "A Model Context Protocol service for searching TikTok videos"
}
}
搜索视频
POST /search - 使用主题标签搜索视频{
"search_terms": ["python", "coding"],
"count": 30 // Optional, defaults to 30
}
资源管理
POST /cleanup - 清理资源和 API 会话
错误处理
该服务包括针对以下方面的全面错误处理：
- API 初始化失败
- 机器人检测问题
- 网络错误
- 速率限制
- 无效的搜索词
发展
内置：
- TikTokAPI
- FastMCP
- 依赖管理的诗歌
- 浏览器自动化的 Playwright
执照
麻省理工学院