Kling

@mindstone/mcp-server-kling

Kling AI video and image generation MCP server for Model Context Protocol hosts. Generate AI videos from text or images, extend them, add lip-sync, generate images, and manage generation tasks through a standardised MCP interface.

Status

• Version: 0.5.0 · npm
• Auth: API key (KLING_ACCESS_KEY)
• Tools: 10 (video-generation, image-generation, tasks, account, downloads)
• Surface: cloud-api
• Machine-readable: STATUS.json

Requirements

• Node.js 20+
• npm

One-click install

After clicking the button, your host will prompt you to fill: KLING_ACCESS_KEY, KLING_SECRET_KEY, KLING_REQUEST_TIMEOUT_MS.

Manual config for Claude Desktop / Claude Code / Goose / Continue.dev (Kling)

{

"mcpServers": { "Kling": { "command": "npx", "args": [ "-y", "@mindstone/mcp-server-kling" ], "env": { "KLING_ACCESS_KEY": "", "KLING_SECRET_KEY": "", "KLING_REQUEST_TIMEOUT_MS": "60000" } } } }

Quick Start

Install & build

cd <path-to-repo>/connectors/kling

npm install npm run build

npx (once published)

npx -y @mindstone/mcp-server-kling

Local

node dist/index.js

Configuration

Environment variables

• KLING_ACCESS_KEY — Kling API access key
• KLING_SECRET_KEY — Kling API secret key
• MCP_HOST_BRIDGE_STATE — optional path to a host bridge state file used for credential management
• MINDSTONE_REBEL_BRIDGE_STATE — backwards-compatible alias for MCP_HOST_BRIDGE_STATE
• MCP_WORKSPACE_PATH — optional directory that local media inputs (image_path, audio_path) must live inside. Defaults to the system temp directory when unset. Files elsewhere are refused before any read.
• KLING_DOWNLOAD_ROOT — optional directory that download_kling_video output paths must live inside. It must itself resolve inside the workspace (MCP_WORKSPACE_PATH, or the system temp directory when unset); anything else is refused with guidance. Default: /kling-downloads (auto-created). Sensitive paths (~/.ssh, ~/.aws, /etc, shell rc files) are refused even when the root would otherwise permit them.
• KLING_REQUEST_TIMEOUT_MS — optional override (positive integer ms, max 30 min) for the outbound HTTP request timeout applied to both Kling API and host-bridge calls. Default: 60000 (60s). Raise this if you see TIMEOUT errors on slow submits; lower it if you want tighter bounds.

Host configuration examples

Claude Desktop / Cursor

{

"mcpServers": { "Kling": { "command": "npx", "args": ["-y", "@mindstone/mcp-server-kling"], "env": { "KLING_ACCESS_KEY": "your-access-key", "KLING_SECRET_KEY": "your-secret-key" } } } }

Local development (no npm publish needed)

{

"mcpServers": { "Kling": { "command": "node", "args": [" /connectors/kling/dist/index.js"], "env": { "KLING_ACCESS_KEY": "your-access-key", "KLING_SECRET_KEY": "your-secret-key" } } } }

Tools (10)

Configuration

• configure_kling_api_keys — Save Kling API credentials

Video generation

• generate_kling_video — Create an AI-generated video from a text description
• generate_kling_image_to_video — Animate a still image into a video (public HTTPS URL or local file via image_path)
• extend_kling_video — Continue a generated video, adding ~4-5 seconds per call
• generate_kling_lip_sync — Make a person in a video speak, from text (text-to-speech) or an audio file

Image generation

• generate_kling_image — Create an AI-generated image from a text description, with optional reference image

Models: the video tools default to kling-v2-6 and the image tool to kling-v2-1. kling-v3 (Kling 3.0) is available on all three generation tools through the model parameter; it costs about twice as many Kling units per second of video and per image, so it is not the default.

Task management

• check_kling_task — Check if a generation task is complete (task types: text2video, image2video, video-extend, lip-sync, image)
• list_kling_tasks — List your generation tasks with pagination
• download_kling_video — Save a generated video or image to a local file (result URLs expire 30 days after generation). Only Kling result URLs (klingai.com hosts) are accepted.

Account

• get_kling_balance — List resource packages on the account and their remaining quantities

All generation tools accept an optional callback_url (HTTPS) that Kling POSTs to on task status changes, as an alternative to polling.

Licence

FSL-1.1-MIT — Functional Source License, Version 1.1, with MIT future licence. The software converts to MIT licence on 2030-04-08.

Host-authorized local inputs

files/readModes version 1 is an experimental extension used by these connectors, not part of the MCP standard. A compatible host (the app running the connector) decides which input files a tool call may read. The connector opens only the host-approved physical path, after resolving symlinks. The host supplies this permission information with each call; it is not a tool argument you need to set. Missing or invalid permission information, or a file absent from the approved list, stops the read.

Clients that do not negotiate this extension keep the connector's existing standalone file restrictions. This extension changes input-read permissions; existing output destinations, upload formats, size limits and file checks apply.