TikTok MCP 服务

概述

TikTok 视频发现和元数据提取的模型上下文协议（Model Context Protocol）服务。此服务提供了一个强大的接口来通过标签搜索TikTok视频，并提取流行内容，内置反检测措施和错误处理。

功能

使用标签搜索视频
每次搜索可配置的视频数量（默认：30）
反机器人检测措施
代理支持
自动 API 会话管理
速率限制和错误处理
健康状态监控

配置

服务使用环境变量进行配置。创建一个.env文件，内容如下：

ms_token=your_tiktok_ms_token  # 可选但推荐以避免反机器人检测
TIKTOK_PROXY=your_proxy_url    # 可选代理配置

安装与设置

# 安装依赖项
poetry install

# 安装浏览器自动化依赖项
poetry run python -m playwright install

# 启动服务
poetry run python -m tiktok_mcp_service.main

与 Claude Desktop 集成

一旦服务运行，您可以将其集成到 Claude Desktop 中。由于我们使用 Poetry 进行依赖管理，请确保通过 Poetry 执行 MCP CLI 命令：

# 切换到项目目录
cd /path/to/tiktok-mcp-service

# 使用可编辑模式安装服务到 Claude Desktop
poetry run mcp install tiktok_mcp_service/main.py --with-editable . -f .env

# 可选：使用自定义名称安装
poetry run mcp install tiktok_mcp_service/main.py --name "TikTok 视频搜索" --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"
  }
}