Douyin MCP
π₯ Douyin (TikTok China) MCP Server - Automated video upload service via Model Context Protocol for AI integration
What is Douyin MCP?
Douyin MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to π₯ douyin (tiktok china) mcp server - automated video upload service via model context protocol for ai integration
π₯ Douyin (TikTok China) MCP Server - Automated video upload service via Model Context Protocol for AI integration
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- π₯ Douyin (TikTok China) MCP Server - Automated video upload
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx douyinConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Douyin MCP
Douyin MCP Server connects Claude and other MCP clients to the Douyin (TikTok China) platform, providing tools to extract video metadata, retrieve watermark-free download links, and transcribe video audio to text using AI-powered speech recognition via SenseVoice. It is built with Python and uses FFmpeg for audio processing, making it useful for content creators, researchers, and automation workflows that need to analyze or repurpose short video content from Douyin programmatically.
Prerequisites
- Python 3.10 or later
- uv package manager (`pip install uv`)
- FFmpeg installed and available on PATH (required for audio extraction)
- A SenseVoice API key from Silicon Flow (free tier available at siliconflow.cn) β required for speech-to-text transcription
- An MCP-compatible client such as Claude Desktop
Clone the repository
Clone the Douyin MCP server repository and enter the project directory.
git clone https://github.com/yzfly/douyin-mcp-server.git
cd douyin-mcp-serverInstall FFmpeg
FFmpeg is required for audio extraction from video files. Install it using your system package manager.
# macOS
brew install ffmpeg
# Ubuntu/Debian
sudo apt-get install ffmpeg
# Windows: download from https://ffmpeg.org/download.htmlInstall Python dependencies
Use uv to install the project's dependencies into an isolated environment.
uv syncSet your SenseVoice API key
Export the API key as an environment variable. You can obtain a free-tier key by registering at siliconflow.cn.
export API_KEY="sk-xxxxxxxxxxxxxxxx"Configure Claude Desktop
Add the Douyin MCP server to your Claude Desktop configuration. Set the `API_KEY` environment variable in the config so the server has access to it when Claude Desktop launches it.
Restart Claude Desktop and test
Restart Claude Desktop and ask it to parse a Douyin video link. The server exposes three tools: `parse_douyin_video_info`, `get_douyin_download_link`, and `extract_douyin_text`.
Douyin MCP Examples
Client configuration
Claude Desktop configuration for the Douyin MCP server. Replace the path and API key with your actual values.
{
"mcpServers": {
"douyin": {
"command": "uv",
"args": ["run", "--project", "/path/to/douyin-mcp-server", "python", "mcp_server.py"],
"env": {
"API_KEY": "sk-xxxxxxxxxxxxxxxx"
}
}
}
}Prompts to try
Sample prompts for using the Douyin MCP server with Claude Desktop.
- "Parse this Douyin video link and show me the title, author, and engagement metrics: [share link]"
- "Get the watermark-free download URL for this Douyin video: [share link]"
- "Transcribe the speech from this Douyin video to text: [share link]"
- "Extract the transcript from this cooking tutorial video and list all the ingredients mentioned."
- "Analyze this Douyin video's metadata and estimate the best time to post similar content."Troubleshooting Douyin MCP
FFmpeg not found error when extracting audio
Ensure FFmpeg is installed and the `ffmpeg` binary is on your system PATH. Run `ffmpeg -version` in a terminal to verify. On macOS, use `brew install ffmpeg`. On Windows, add the FFmpeg `bin` directory to the PATH environment variable after downloading.
Speech transcription fails or returns empty results
Verify the `API_KEY` environment variable is set and contains a valid SenseVoice/Silicon Flow API key. The free tier has usage limits β check your quota at siliconflow.cn. Videos longer than 1 hour or larger than 50 MB are automatically split into segments; ensure there is sufficient disk space for temporary files.
Douyin share links return 404 or fail to parse
Douyin share links expire or may be region-restricted. Use the full video URL from the Douyin app's share function, not a shortened link copied from a chat. If the link was shared more than 24 hours ago, request a fresh share link from the video.
Frequently Asked Questions about Douyin MCP
What is Douyin MCP?
Douyin MCP is a Model Context Protocol (MCP) server that π₯ douyin (tiktok china) mcp server - automated video upload service via model context protocol for ai integration It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Douyin MCP?
Follow the installation instructions on the Douyin MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Douyin MCP?
Douyin MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Douyin MCP free to use?
Yes, Douyin MCP is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
Douyin MCP Alternatives β Similar Communication Servers
Looking for alternatives to Douyin MCP? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
β 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
β 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
β 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
β 5.8kπ¬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
β 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
β 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Douyin MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Douyin MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.