TikTok → Reddit Poster MCP

A minimal MCP server for downloading TikTok videos, optional transcription, subreddit & title suggestions, and posting native Reddit videos with auto-comment for source links.

Features

• FFmpeg Auto-Detection: Works on Windows, Linux, and macOS.

• Robust Error Recovery: Multi-layer fallback for WebSocket and API errors.

• Video Validation & Transcoding: Converts videos to Reddit-compatible MP4.

• Auto-Commenting: Automatically comments the original TikTok link if none is provided.

Requirements

• Python ≥ 3.8

• FFmpeg (auto-detected; install if missing)

• (Optional) CUDA + cuDNN for GPU transcription

Installation

Python Dependencies

pip install praw requests yt-dlp websockets aiohttp aiofiles asyncpraw
# Optional transcription support
pip install faster-whisper

System Dependencies

• Windows:

  • Chocolatey: choco install ffmpeg

  • Scoop: scoop install ffmpeg

  • Or download manually from ffmpeg.org

• Linux (Debian/Ubuntu): sudo apt update && sudo apt install ffmpeg python3-dev

• macOS: brew install ffmpeg

Package Installation

pip install -e .

Environment Setup

Copy the example file and update your credentials:

cp .env.example .env

Fill in your Reddit API credentials (REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME, REDDIT_PASSWORD) in the .env file. Without these, the server functions in read-only mode.

Usage

Start the MCP server:

python server.py          # default port 8050
python server.py --port 9001

Access API docs at: http://localhost:<port>/docs (use Bearer <MCPO_API_KEY> if set).

Auto-Comment Logic

The post_downloaded_video function auto-generates a comment if none is provided and an original TikTok URL exists:

• en: Original link: <url>

• pt: Link original: <url>

• both: Original link / link original: <url>

Troubleshooting

• FFmpeg Not Found: Run python install_ffmpeg.py or install manually.

• Reddit API Errors: Ensure your .env file is correctly set up.

• WebSocket Errors: The system auto-recovers and retries; check logs for "WebSocket failed" messages.

• Fallback: If PRAW fails, a direct Reddit API call is attempted automatically.