tiktok

This TikTok MCP exposes tools that integrate TikTok access into Claude AI and other apps via TikNeuron. It includes capabilities to fetch video subtitles, retrieve post details, and search for TikTok videos, all designed to help you analyze virality factors, extract content, and chat about TikTok videos. To use it, install and run the MCP server locally, then reference it in your MCP configuration so your apps can invoke the provided tools. The primary tools available are: tiktok_get_subtitle (returns subtitles or ASR text for a given TikTok URL), tiktok_get_post_details (retrieves metadata such as description, creator, hashtags, engagement metrics, duration, and available subtitles), and tiktok_search (queries TikTok and returns a list of matching videos with details and pagination data). These tools are designed to be called with the required parameters (for example, a TikTok URL for subtitles or post details) and optional language codes or pagination parameters as described in the README. The MCP handles authentication with TikNeuron via an API key, enabling seamless access to protected features when you provide the key in your environment.

Prerequisites:

• Node.js v18 or higher
• Git
• Optional: TikNeuron Account and MCP API Key

Install and run the TikTok MCP locally:

1. Clone the repository: git clone https://github.com/Seym0n/tiktok-mcp.git
2. Install dependencies: npm install
3. Build the project (produces build/index.js): npm run build
4. Run the MCP server (example): node path\build\index.js
5. In your Claude configuration, register the MCP server under mcpServers (see example in the README). Ensure you provide your TikNeuron MCP API Key in the environment as TIKNEURON_MCP_API_KEY.

Optional MCPB installation (Clude Desktop):

• If you use the MCPB bundle, download tiktok-mcp.mcpb from Releases and install via Claude Desktop, entering your TikNeuron API Key when prompted.

Tips and caveats:

• Keep your TikNeuron MCP API Key secure; avoid committing it to source control.
• The tiktok_search tool supports pagination via cursor and search_uid; use these to fetch more results.
• When using tiktok_get_subtitle, you can omit language_code to get the default ASR subtitle.
• Ensure Node.js version compatibility with any native modules used during build.
• If you encounter missing build artifacts, run npm install and npm run build again.
• The MCP configuration example uses path\build\index.js; adapt the path to your actual build output location.