README
🚀 跑道API MCP服务器
本仓库包含一个调用跑道(Runway)API的MCP服务器代码。该项目可借助跑道API实现图像、视频的生成、编辑、放大等功能,为相关开发提供便利。

为演示目的,视频已加速
🚀 快速开始
在开始使用前,你需要完成以下准备工作并进行相应设置:
🔍 前提条件
⚙️ 设置步骤
- 克隆此仓库并将其保存到你计算机上的一个文件夹中。记住你保存该文件夹的位置,因为后续步骤会用到。
- 在该文件夹中运行
npm install,然后运行npm run build。此时你应该会看到一个名为build的新文件夹,里面有一个index.js文件。
🖥️ 与Claude桌面版配合使用
- 按照 MCP快速入门说明 为Claude设置一个配置文件。如果你已经有配置文件,可以通过以下命令打开:
- MacOS
open ~/Library/Application\ Support/Claude/claude_desktop_config.json- Windows
notepad %APPDATA%\Claude\claude_desktop_config.json - 将
runway-api-mcp-server添加到配置文件中,确保替换文件路径和跑道API密钥。
{
"mcpServers": {
"runway-api-mcp-server": {
"command": "node",
"args": [
"<步骤1中克隆仓库的绝对路径>/build/index.js"
],
"env": {
"RUNWAYML_API_SECRET": "<你的跑道API密钥>",
"MCP_TOOL_TIMEOUT": "1000000"
}
}
}
}
- 现在重启Claude桌面版,你应该会在Claude的工具列表中看到
runway-api-mcp-server。

- 现在,尝试让Claude生成图像或视频!
⚠️ 重要提示
跑道API生成的图像仅在生成链接上保留24小时。链接过期后无法恢复这些图像。请务必在图像过期前下载。
✨ 主要特性
此MCP中提供了以下工具:
| 工具名称 | 描述 | 参数 |
| ---------------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| runway_generateVideo | 根据图像和文本提示生成视频 | - promptImage
- promptText(可选)
- ratio
- duration |
| runway_generateImage | 根据文本提示和参考图像生成图像 | - promptText
- referenceImages(注意,上传的图像不能作为参考,只有之前生成的图像或图像的URL才有效。)
- ratio |
| runway_upscaleVideo | 将视频提升到更高分辨率 | - videoUri |
| runway_editVideo | 编辑视频,可选择提供参考图像。 | - videoUri, referenceImages, promptText |
| runway_getTask | 获取任务的详细信息 | - taskId |
| runway_cancelTask | 取消或删除任务 | - taskId |
| runway_getOrg | 获取组织信息 |
Scan to join WeChat group