TikTok MCP 服务

用于 TikTok 视频发现和元数据提取的模型上下文协议服务。该服务提供了一个强大的界面，可通过主题标签搜索 TikTok 视频并检索热门内容，并内置了反检测措施和错误处理功能。

特征

• 按主题标签搜索视频

• 可配置每次搜索的视频数量（默认值：30）

• 反机器人检测措施

• 代理支持

• 自动 API 会话管理

• 速率限制和错误处理

• 健康状态监测

Related MCP server: DuckDuckGo Web Search MCP Server

配置

该服务使用环境变量进行配置。创建一个.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
  }

  回复包括视频 URL、描述和参与度统计数据（观看次数、喜欢次数、分享次数、评论次数）。

资源管理

• POST /cleanup - 清理资源和 API 会话

错误处理

该服务包括针对以下方面的全面错误处理：

• API 初始化失败

• 机器人检测问题

• 网络错误

• 速率限制

• 无效的搜索词

发展

内置：

• TikTokAPI

• FastMCP

• 依赖管理的诗歌

• 浏览器自动化的 Playwright

执照

麻省理工学院