Kling

@mindstone/mcp-server-kling

面向 Model Context Protocol 宿主的 Kling AI 视频和图像生成 MCP 服务。通过标准化的 MCP 接口，根据文本或图像生成 AI 视频、扩展视频、添加口型同步、生成图像，并管理生成任务。

状态

• 版本： 0.4.1 · npm
• 身份验证： API 密钥（KLING_ACCESS_KEY）
• 工具： 10（视频生成、图像生成、任务、账户、下载）
• 接口： cloud-api
• 机器可读： STATUS.json

要求

• Node.js 20+
• npm

一键安装

点击按钮后，宿主会提示你填写：KLING_ACCESS_KEY、KLING_SECRET_KEY、KLING_REQUEST_TIMEOUT_MS。

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

快速开始

安装和构建

cd <path-to-repo>/connectors/kling
npm install
npm run build

npx（发布后使用）

npx -y @mindstone/mcp-server-kling

本地

node dist/index.js

配置

环境变量

• KLING_ACCESS_KEY — Kling API 访问密钥
• KLING_SECRET_KEY — Kling API 密钥
• MCP_HOST_BRIDGE_STATE — 可选的宿主桥接状态文件路径，用于凭据管理
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE 的向后兼容别名
• MCP_WORKSPACE_PATH — 可选目录，本地媒体输入（image_path、audio_path）必须位于其中。未设置时默认为系统临时目录。读取文件前会拒绝处理其他位置的文件。
• KLING_DOWNLOAD_ROOT — 可选目录，download_kling_video 的输出路径必须位于其中。该目录本身必须解析到工作区（MCP_WORKSPACE_PATH；未设置时为系统临时目录）内；否则会拒绝操作并提供说明。默认值：<workspace>/kling-downloads（自动创建）。即使根目录允许，仍会拒绝敏感路径（~/.ssh、~/.aws、/etc、shell rc 文件）。
• KLING_REQUEST_TIMEOUT_MS — 可选覆盖值（正整数毫秒，最长 30 min），用于设置发往 Kling API 和宿主桥接调用的 HTTP 请求超时时间。默认值：60000（60s）。如果慢速提交时出现 TIMEOUT 错误，请调高此值；如果希望缩短等待时间上限，请调低此值。

宿主配置示例

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"
      }
    }
  }
}

本地开发（无需发布到 npm）

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

工具（10）

配置

• configure_kling_api_keys — 保存 Kling API 凭据

视频生成

• generate_kling_video — 根据文本描述创建 AI 生成的视频
• generate_kling_image_to_video — 将静态图像制作成视频（使用公开的 HTTPS URL，或通过 image_path 指定本地文件）
• extend_kling_video — 续接生成的视频，每次调用增加约 4-5 秒
• generate_kling_lip_sync — 根据文本（文本转语音）或音频文件，让视频中的人物说话

图像生成

• generate_kling_image — 根据文本描述创建 AI 生成的图像，可选提供参考图像

任务管理

• check_kling_task — 检查生成任务是否完成（任务类型：text2video、image2video、video-extend、lip-sync、image）
• list_kling_tasks — 分页列出你的生成任务
• download_kling_video — 将生成的视频或图像保存到本地文件（结果 URL 会在生成 30 天后过期）。仅接受 Kling 结果 URL（klingai.com 主机）。

账户

• get_kling_balance — 列出账户上的资源包及剩余数量

所有生成工具都可选接受 callback_url（HTTPS），任务状态变化时，Kling 会向该 URL 发送 POST 请求，可作为轮询的替代方式。

许可证

FSL-1.1-MIT — Functional Source License，Version 1.1，后续许可证为 MIT。该软件将于 2030-04-08 转为 MIT 许可证。