TikTok

A Model Context Protocol service for TikTok video discovery and metadata extraction.

python

67

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "yap-audio-tiktok-mcp": {
      "command": "poetry",
      "args": [
        "run",
        "python",
        "-m",
        "tiktok_mcp_service.main"
      ],
      "env": {
        "ms_token": "YOUR_MS_TOKEN",
        "TIKTOK_PROXY": "YOUR_PROXY_URL"
      }
    }
  }
}

You can run a TikTok MCP Server that searches TikTok videos by hashtags, retrieves trending content, and manages sessions with anti-detection measures. It exposes a simple HTTP/stdio interface for integration and handles errors and health monitoring, making it easy to build rich data workflows around TikTok media and metadata.

How to use

You access the TikTok MCP Server through an MCP client that communicates via standard MCP protocols. Start by ensuring the server is running, then use the available endpoints to health-check, search videos by hashtags, or clean up sessions and resources.

How to install

Prerequisites you need before installation: Python and Poetry.

Install dependencies and required browser automation components, then start the service using the provided runtime command.

poetry install
poetry run python -m playwright install
poetry run python -m tiktok_mcp_service.main

Available tools

health_check

Checks service health and API initialization status to ensure the MCP is ready to serve requests.

search_videos

Search TikTok videos by hashtags and return results with URLs, descriptions, and engagement metrics.

cleanup

Clean up resources and API sessions to free up memory and maintain stability.