ReClip

What ReClip MCP server does

The ReClip MCP server gives an MCP host local tools for working with media URLs supported by yt-dlp. It can inspect a URL, download a video as MP4, extract audio as MP3, create a clip between two timestamps, and report the sites supported by the underlying downloader.

Supported sources include YouTube, TikTok, Instagram, Twitter/X, Reddit, Facebook, Vimeo, Twitch, Dailymotion, SoundCloud, Loom, Streamable, Pinterest, Tumblr, Threads, LinkedIn, and other sites recognized by yt-dlp. The actual availability of a URL depends on yt-dlp support and the source site's access requirements.

The ReClip MCP server is intended for local, authorized use. Its download operations require explicit user authorization and can write only inside the configured download directory.

How it works

An MCP host starts the server through uvx and communicates with it over standard input and output. The server invokes yt-dlp for media inspection and retrieval, while ffmpeg supports media conversion and clipping. Results from download operations include the output path, filename, byte size, selected format, source URL, and clip range.

The inspection tool can load media information before a download. A download can specify MP4 or MP3, a quality selection, and an output location within the permitted directory. Clip requests accept times in SS, MM:SS, or HH:MM:SS.000 form. The server also provides a site-listing tool so an agent can check the declared yt-dlp coverage.

Setup and configuration

Install and run the package through an MCP host using a configuration similar to:

{
  "mcpServers": {
    "reclip": {
      "command": "uvx",
      "args": ["reclip-mcp"],
      "env": {
        "RECLIP_MCP_DOWNLOAD_DIR": "/absolute/path/to/downloads"
      }
    }
  }
}

RECLIP_MCP_DOWNLOAD_DIR sets the directory where download tools may save files. If omitted, the default is ~/Downloads/ReClip. Use the absolute path to uvx when the MCP host does not inherit the executable from the shell PATH.

For development from a checkout, install the project with python -m pip install . and configure the host to run python -m reclip_mcp. The package requires Python 3.10 or newer. The repository also provides a local web application and command-line interface, but those are separate ways to use ReClip rather than MCP configuration requirements.

Tools and capabilities

The ReClip MCP server exposes these tools:

• inspect_media: retrieves information about a media URL.
• download_media: saves a selected video or audio representation locally.
• download_clip: saves only a requested time range.
• list_supported_sites: reports supported site coverage.

Downloads support MP4 video, MP3 audio, quality selection, and local output paths constrained by the configured directory.

Limitations and notes

The server contacts the media sites represented by URLs supplied to it.

Some YouTube operations may require Deno or Node.js because yt-dlp uses a JavaScript runtime for player challenges. Media availability can also change with the source site's behavior and yt-dlp compatibility. Users are responsible for authorization, copyright compliance, and adherence to each platform's terms of service.