TikTok MCP Service

by yap-audio

Integrations

  • Enables searching for TikTok videos by hashtags and retrieving trending content, with complete video metadata including URLs, descriptions, and engagement statistics (views, likes, shares, comments).

TikTok MCP Service

A Model Context Protocol service for TikTok video discovery and metadata extraction. This service provides a robust interface for searching TikTok videos by hashtags and retrieving trending content, with built-in anti-detection measures and error handling.

Features

  • Search videos by hashtags
  • Configurable video count per search (default: 30)
  • Anti-bot detection measures
  • Proxy support
  • Automatic API session management
  • Rate limiting and error handling
  • Health status monitoring

Configuration

The service uses environment variables for configuration. Create a .env file with:

ms_token=your_tiktok_ms_token # Optional but recommended to avoid bot detection TIKTOK_PROXY=your_proxy_url # Optional proxy configuration

Installation and Setup

# 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 Desktop Integration

Once your service is running, you can integrate it with Claude Desktop. Since we're using Poetry for dependency management, make sure to run the MCP CLI commands through Poetry:

# 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

After installation, the service will be available in Claude Desktop and will run using Poetry for proper dependency management.

API Endpoints

Health Check

  • GET /health - Check service health and API initialization status
    { "status": "running", "api_initialized": true, "service": { "name": "TikTok MCP Service", "version": "0.1.0", "description": "A Model Context Protocol service for searching TikTok videos" } }

Search Videos

  • POST /search - Search for videos with hashtags
    { "search_terms": ["python", "coding"], "count": 30 // Optional, defaults to 30 }
    Response includes video URLs, descriptions, and engagement statistics (views, likes, shares, comments).

Resource Management

  • POST /cleanup - Clean up resources and API sessions

Error Handling

The service includes comprehensive error handling for:

  • API initialization failures
  • Bot detection issues
  • Network errors
  • Rate limiting
  • Invalid search terms

Development

Built with:

  • TikTokApi
  • FastMCP
  • Poetry for dependency management
  • Playwright for browser automation

License

MIT

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides a robust interface for searching TikTok videos by hashtags and retrieving trending content, with anti-detection measures and comprehensive metadata extraction.

  1. Features
    1. Configuration
      1. Installation and Setup
        1. Claude Desktop Integration
          1. API Endpoints
            1. Health Check
            2. Search Videos
            3. Resource Management
          2. Error Handling
            1. Development
              1. License

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  Enables efficient web search integration with Jina.ai's Search API, offering clean, LLM-optimized content retrieval with support for various content types and configurable caching.
                  Last updated -
                  1
                  22
                  3
                  JavaScript
                  MIT License
                • -
                  security
                  F
                  license
                  -
                  quality
                  Enables extraction of transcript text from YouTube videos by providing the video URL, supporting standard, shortened, and embed URL formats.
                  Last updated -
                  1
                  JavaScript
                • A
                  security
                  A
                  license
                  A
                  quality
                  Bridges YouTube API and AI assistants, enabling video analysis by downloading and processing closed captions to create summaries of YouTube videos.
                  Last updated -
                  1
                  3
                  Python
                  MIT License
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  A MCP Server for TikTok videos that allows you to get video subtitles and post details, such as the number of likes, hashtags, and publishing time.
                  Last updated -
                  54
                  31
                  JavaScript
                  MIT License

                View all related MCP servers

                ID: skxjn3gdmg