kling-mcp

RunAPI Kling MCP 服务

为 AI Agent 提供 Kling API 访问能力：通过一个专用 MCP 服务执行视频生成操作、轮询异步结果并查询定价。

_{兼容 Claude Code、Codex、Cursor、Windsurf、VS Code、Roo Code，以及任何兼容 MCP 的宿主。}

安装 | 工具 | 模型 | Agent 提示词 | 配置 | 链接

---

为什么选择这个软件包？

@runapi.ai/kling-mcp 是一个专用于 RunAPI Kling 模型系列的 Model Context Protocol 服务。 它让兼容 MCP 的助手能够直接访问 6 个端点和 16 种模型变体，无需加载完整的 RunAPI 目录。

当 Agent 应仅使用 Kling 时，请使用这个专用模型服务。当一个助手需要发现 RunAPI 的所有模型系列时，请使用 @runapi.ai/mcp。

kling-ai-avatar-v1-pro 已于 2026-10-14T00:00:00Z 停用。新请求会在创建任务或扣除余额之前返回 HTTP 410。仍可查询现有任务。此模型 ID 不会映射到其他模型。

kling-v1-avatar-standard 已于 2026-10-14T00:00:00Z 停用。新请求会在创建任务或扣除余额之前返回 HTTP 410。仍可查询现有任务。此模型 ID 不会映射到其他模型。

---

安装

将其添加到 Claude Code：

claude mcp add kling -s user -- npx -y @runapi.ai/kling-mcp

如果要在仓库中共享此服务，请使用项目范围：

claude mcp add kling -s project -- npx -y @runapi.ai/kling-mcp

Codex、Cursor、Windsurf、VS Code、Roo Code 和其他 MCP 宿主可以使用相同的 stdio 命令：

{
  "mcpServers": {
    "kling": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/kling-mcp"]
    }
  }
}

无需登录即可使用 check_pricing。要创建任务并轮询状态，请让你的助手调用 login 工具。它会打开浏览器登录，并将凭据保存到 ~/.config/runapi/config.json；runapi login 也使用同一文件。 无头环境和 CI 宿主仍可在启动 MCP 宿主之前设置 RUNAPI_API_KEY。

examples/ 中提供了适用于 Claude、Cursor、Windsurf、VS Code 和 Roo Code 的现成示例。

---

工具

工具	身份验证	用途
ai_avatar	是	创建 Kling AI 虚拟形象任务，并可选择等待任务进入终态。返回任务 ID、状态和输出 URL。
edit_video	是	创建 Kling 视频编辑任务，并可选择等待任务进入终态。返回任务 ID、状态和输出 URL。
extend_video	是	创建 Kling 视频延长任务，并可选择等待任务进入终态。返回任务 ID、状态和输出 URL。
image_to_video	是	创建 Kling 图生视频任务，并可选择等待任务进入终态。返回任务 ID、状态和输出 URL。
motion_control	是	创建 Kling 动作控制任务，并可选择等待任务进入终态。返回任务 ID、状态和输出 URL。
text_to_video	是	创建 Kling 文生视频任务，并可选择等待任务进入终态。返回任务 ID、状态和输出 URL。
get_task	是	获取现有任务的当前状态和最新内容。
check_pricing	否	查询 Kling 模型和端点的当前定价。

---

模型

Kling 在 6 个端点上提供 16 种模型变体。每个工具都接受为其列出的模型：

工具	模型
ai_avatar	kling-ai-avatar-pro、kling-ai-avatar-standard
edit_video	kling-v3-omni-edit、kling-v3-omni-reference
extend_video	kling-v2.5-turbo-image-to-video-pro、kling-v2.5-turbo-text-to-video-pro
image_to_video	kling-o1、kling-v2.1-master-image-to-video、kling-v2.1-pro、kling-v2.1-standard、kling-v2.5-turbo-image-to-video-pro、kling-v2.6、kling-v3-omni、kling-v3-turbo-image-to-video
motion_control	kling-3.0、kling-v2.6
text_to_video	kling-3.0、kling-o1、kling-v2.1-master-text-to-video、kling-v2.5-turbo-text-to-video-pro、kling-v2.6、kling-v3-omni、kling-v3-omni-reference、kling-v3-turbo-text-to-video

不同版本发布时，可用模型可能会发生变化。请使用 check_pricing 或 Kling 模型页面查看当前目录。

---

Agent 提示词

用自然语言向助手提出请求；它可以查询定价、创建任务，并返回任务 ID 和输出 URL。

创建任务

Run a Kling ai avatar task with RunAPI.

助手可以调用 check_pricing，然后调用 ai_avatar，并返回任务 ID、状态和输出 URL。

提交任务但不等待

Create the task but don't wait for it to finish.

助手调用创建工具并设置 wait: false，然后返回任务 ID。之后可使用 get_task 查看任务状态。

创建任务前查询定价

Check current Kling pricing, then create the task if it matches my request.

助手调用 check_pricing，并可链接到 Kling 模型页面，以查看规范的目录条目。

---

配置

服务器按以下顺序解析身份验证信息：

1. RUNAPI_API_KEY 环境变量，适用于无头环境和 CI 主机
2. ~/.config/runapi/config.json，由 MCP login 工具或 runapi login 创建
3. 不提供密钥，此时仍可使用 check_pricing

配置文件通常由登录流程管理。预配置的无头环境配置可以使用：

{
  "apiKey": "your_runapi_key"
}

请勿提交真实的 API 密钥。

---

链接

资源	URL
Kling 模型页面	https://runapi.ai/models/kling
npm 包	@runapi.ai/kling-mcp
GitHub 仓库	runapi-ai/kling-mcp
RunAPI MCP 概览	runapi.ai/mcp
RunAPI 文档	runapi.ai/docs

---

许可证

根据 Apache License, Version 2.0 授权。