TikTok MCP 服务

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

功能

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

配置

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

ms_token=你的_tiktok_ms_token  # 可选，但建议使用以避免机器人检测
TIKTOK_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

# 使用 Poetry 以可编辑模式在 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": "一个用于搜索 TikTok 视频的模型上下文协议服务"
    }
  }
  

搜索视频

• POST /search - 使用标签搜索视频

  {
    "search_terms": ["python", "coding"],
    "count": 30  // 可选，默认为 30
  }
  

  响应包括视频 URL、描述和互动统计数据（观看次数、点赞数、分享数、评论数）。

资源管理

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

错误处理

该服务包括全面的错误处理，用于：

• API 初始化失败
• 机器人检测问题
• 网络错误
• 速率限制
• 无效的搜索词

开发

使用以下技术构建：

• TikTokApi
• FastMCP
• Poetry 用于依赖管理
• Playwright 用于浏览器自动化

许可证

MIT