使用说明

项目简介

Runway Video MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它通过 RunwayAPI 提供强大的图片转视频功能。用户可以向该服务器发送图片（URL、本地文件或Base64编码），并可选地添加文本提示，服务器将调用 RunwayAPI 生成视频，并返回视频的访问链接。此服务器设计为 MCP 工具，可以方便地集成到支持 MCP 协议的 LLM 客户端，例如 Claude.app。

主要功能点

图片转视频: 支持将各种格式的图片转换为视频，包括但不限于风景、人物、动画等。
多种图片输入方式: 支持通过图片 URL、本地上传的图片文件路径以及 Base64 编码的图片数据作为输入。
可选的提示文本: 允许用户提供额外的文本提示 (promptText) 来指导视频生成，从而更精细地控制视频内容。
MCP 工具集成: 遵循 MCP 协议标准，易于集成到任何支持 MCP 协议的 LLM 客户端，扩展 LLM 的多媒体处理能力。

安装步骤

安装 npm 包: 使用 npm 安装 Runway Video MCP Server 包。

npm install @kamechan/runway-video-server

服务器配置

要将 Runway Video MCP Server 集成到 MCP 客户端（例如 Claude.app），您需要在客户端的配置文件中添加服务器配置信息。以下是 Claude.app 配置文件 ('@claude_desktop_config.json') 的配置示例：

{
  "mcpServers": {
    "runway-video-server": {  // 服务器名称，用户自定义，用于在客户端中标识和引用
      "command": "npx",      // 启动服务器的命令，这里使用 npx 运行 npm 包
      "args": [             // 启动命令的参数
        "-y",               // npx 参数，自动确认执行 npm 包
        "@kamechan/runway-video-server" // 要执行的 npm 包名称，即 Runway Video MCP Server
      ],
      "env": {              // 环境变量配置
        "RUNWAY_API_KEY": "YOUR_RUNWAY_API_KEY_HERE" // RunwayAPI 密钥，请替换为您的实际密钥
      }
    }
  }
}

请务必将 'YOUR_RUNWAY_API_KEY_HERE' 替换为您在 RunwayML 平台申请的 API 密钥。 这个密钥用于服务器访问 RunwayAPI 服务，是视频生成功能的核心依赖。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您就可以使用 'generate_video' 工具了。

使用示例：

使用图片 URL 生成视频:

请使用以下图片 URL 生成视频: https://example.com/input-image.jpg，并添加提示语：生机勃勃的春天景象。

使用本地上传的图片文件生成视频: 先将本地图片文件上传到 LLM 客户端（通常是拖拽上传），然后在对话中指示：

请用我上传的这张图片生成视频，提示语：充满未来感的城市夜景。

使用 Base64 编码的图片数据生成视频 (通常由程序调用):

{
  "tool_calls": [
    {
      "id": "call_123",
      "type": "function",
      "function": {
        "name": "generate_video",
        "arguments": {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAA...",
          "promptText": "梦幻般的星空。"
        }
      }
    }
  ]
}

在 LLM 客户端中，您可以像调用其他工具一样调用 'generate_video' 工具，并根据需要提供图片和提示文本，服务器将异步处理视频生成任务，并在完成后返回视频的链接。

关键词