douyin

This MCP server provides a Douyin (TikTok in China) video parsing and downloading service that conforms to the Model Context Protocol (MCP). It can parse a Douyin share link to obtain a no-watermark video URL, download the video file, and return video metadata along with the saved file name. The server exposes tools for getting a download link, downloading the video, and parsing video information, and it reports the actual saved file name (e.g., {videoId}.mp4) so you can easily integrate results into automation pipelines. To use it with an MCP client, configure the client to communicate via the stdio transport and point it to the provided command and arguments.

Key capabilities include:

• get_douyin_download_link: accepts a Douyin share link or text containing a link and returns a no-watermark video URL.
• download_douyin_video: downloads the video file using the provided share link and saves it to the configured working directory.
• parse_douyin_video_info: returns video metadata such as id, duration, format, and file name.

In practice, you would first retrieve a downloadable link, then initiate a download using that link, and optionally inspect or log the video information for auditing or automation purposes.

Prerequisites:

• Node.js 18+ environment (the server is built with Node.js/TypeScript).
• npm or pnpm available on your system.
• Optional: a preferred working directory for outputs (default is .data).

Installation options:

A) NPX (recommended for quick start)

1. Ensure Node.js is installed.
2. Run the MCP server directly via NPX: pnpx @yc-w-cn/douyin-mcp-server

B) Global installation (for persistent usage)

1. Ensure Node.js is installed.
2. Install globally: pnpm install -g @yc-w-cn/douyin-mcp-server
3. Run the server: douyin-mcp-server

Configuration tips:

• You can optionally set a working directory via the WORK_DIR environment variable to customize where files are saved. If not set, the server uses the default .data directory.
• For Claude Desktop or other MCP clients, configure the mcpServers entry with the appropriate command and arguments (see mcp_config example).

Tips and common considerations:

• The server saves downloaded videos as {videoId}.mp4 in the configured working directory. Ensure the directory is writable by the process.
• If you encounter download failures, verify the Douyin share link validity and network access. Some links may expire or require additional handling if regional restrictions apply.
• To debug, enable detailed logs (e.g., DEBUG=douyin-mcp-server) when starting the server.
• The npm package name to reference in MCP client configurations is @yc-w-cn/douyin-mcp-server (used in NPX/CLI invocations).
• If you extend or customize the integration, you can adjust the WORK_DIR to organize outputs per project or automation workflow.