luma-mcp

RunAPI Luma MCP 服务

为 AI Agent 提供 Luma 历史任务访问能力：通过一个专用 MCP 服务查询现有任务。

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

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

---

为什么选择此软件包？

@runapi.ai/luma-mcp 是一款专为 RunAPI 上的 Luma 模型系列打造的 Model Context Protocol 服务。 它让兼容 MCP 的助手能够直接访问 0 个端点和 0 个模型变体，无需加载完整的 RunAPI 目录。

当 Agent 需要专注于 Luma 时，请使用此单模型服务。如果需要让一个助手发现所有 RunAPI 模型系列，请使用 @runapi.ai/mcp。

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

---

安装

将其添加到 Claude Code：

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

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

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

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

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

此软件包中的模型均不接受新任务。check_pricing 不会返回受支持的模型。若要查找历史任务，请让助手调用 login 工具。该工具会打开浏览器登录并将凭据保存到 ~/.config/runapi/config.json，此文件也由 runapi login 使用。 无头和 CI 宿主仍可在启动 MCP 宿主之前设置 RUNAPI_API_KEY。

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

---

工具

工具	身份验证	用途

| get_task | 是 | 获取现有任务的当前状态和最新负载。 | | check_pricing | 否 | 由于此模型系列已停用，不会返回受支持的模型。 |

---

模型

Luma 涵盖 0 个端点上的 0 个模型变体。每个工具都接受为其列出的模型：

工具	模型

模型的可用情况可能随版本而变化。请使用 check_pricing 或查看 Luma 模型页面 获取当前目录信息。

---

Agent 提示词

使用 get_task 查询现有任务。对此已停用模型的新请求会返回 HTTP 410。

Check the status of my existing Luma task with RunAPI.

助手会使用任务 ID 调用 get_task，并返回任务状态和可用结果。

---

配置

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

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

配置文件通常由登录流程管理。预先配置的无头配置可以采用以下形式：

{
  "apiKey": "your_runapi_key"
}

请勿提交真实的 API 密钥。

---

Links

Resource	URL
Luma model page	https://runapi.ai/models/luma
npm package	@runapi.ai/luma-mcp
GitHub repository	runapi-ai/luma-mcp
RunAPI MCP overview	runapi.ai/mcp
RunAPI docs	runapi.ai/docs

---

License

Licensed under the Apache License, Version 2.0.