douyin

This MCP server implements a Douyin (TikTok China) uploader that lets large language models interact with Douyin's creator platform through the MCP protocol. It supports logging in via a browser automation flow, persisting cookies for resale of sessions, uploading videos with metadata (title, description, tags), and handling SMS verification and permissions prompts during automation. Tools exposed via MCP include douyin_login, douyin_check_login, douyin_upload_video, douyin_get_cookies, and douyin_clear_cookies, enabling seamless integration with MCP-enabled LLM tools like Claude.

To use it, configure Claude Desktop (or any MCP client) to point at the MCP server entry script, then call the available MCP tools to perform actions. For example, login to Douyin, check login status, and upload a video with a specific title and description. The uploader will manage browser sessions, persist login state, and optionally publish immediately or save as drafts depending on the autoPublish flag. If SMS verification is required, the system will prompt for the code in the terminal.

Prerequisites:

• Node.js 18+ installed
• npm or yarn
• Git (for cloning, if starting from source)

Step-by-step:

1. Clone the repository git clone https://github.com/lancelin111/douyin-mcp-server.git cd douyin-mcp-server

2. Install root dependencies npm install

3. Install MCP server dependencies inside the mcp-server directory cd mcp-server npm install

4. Build the TypeScript sources npm run build

5. Run the MCP server npm start

6. Configure Claude Desktop (or your MCP client) to load the server, pointing to the built entry file, for example: { "mcpServers": { "douyin": { "command": "node", "args": ["path/to/douyin-mcp-server/mcp-server/dist/index.js"], "env": {} } } }

Tips and caveats:

• Ensure you have a Douyin creator account and a stable network connection for upload flows.
• Cookie persistence is key for avoiding repeated logins; monitor cookie expiry and re-login as needed.
• Puppeteer (Chromium) will be downloaded automatically; ensure your system has enough resources for browser automation.
• If you encounter login or upload failures, check the terminal logs for actionable error messages and consider running with headless: false for debugging visuals.
• Be mindful of Douyin's publishing limits and content policies to avoid account restrictions.