WavespeedMCP

WaveSpeed MCP 服务

适用于 WaveSpeed 平台的 MCP 服务：可从 Claude Code、Claude Desktop、Cursor、Cline 或任何 MCP 客户端运行实时目录中的任意模型，涵盖图像、视频、音频和 3D。

采用与开源 @wavespeed/cli 相同的设计：

• run_model 不会硬编码模型。 目录来自实时 API（缓存 1 小时）；平台上的新模型发布当天即可使用。
• 一个通用动词，五个快捷工具。 run_model 可执行任何操作；get_model_schema 会告知 Agent 某个模型实际接受哪些输入，让它先读取再写入。generate_image、edit_image、generate_video、edit_video 和 extend_video 则无需此步骤：它们使用 WaveSpeed /chat 页面上的相同模型，根据你提供的内容选择端点，并按照实时架构调整请求。
• 输入绝不会被修改。 唯一明确的转换是 @path 标记——在 input 中使用 "@./photo.jpg" 值会上传文件，并将其替换为托管 URL。不带标记的路径会原样传递。快捷工具（如 generate_image）是例外：它们会选择端点并调整请求以适配模型，并在 notes 中说明所做的更改。
• 消费前先报价。 get_price 接受与 run_model 相同的输入并返回预估费用；实际运行的扣费金额以最终结果为准。

工具

工具	功能
list_models	按文本或模态类型搜索实时目录
get_model_schema	获取模型的实际输入架构（必填项、属性、默认值），并附上模型 playground 页面的链接
run_model	提交并等待；拒绝模型不接受的输入键；@path 输入会自动上传；返回输出 URL
generate_image	使用 /chat 图像模型根据提示词生成图像（默认 Seedream 5 Pro）；参考图像使用模型的编辑端点
edit_image	使用相同模型编辑、重设风格或组合现有图像
generate_video	使用 /chat 视频模型，根据提示词、首帧/末帧或参考图像/视频/音频生成视频（默认 Seedance 2.5）；根据输入选择模式（文本、图像、参考）
edit_video	编辑现有视频，可选择提供参考图像/音频
extend_video	使用新片段延续现有视频
get_price	估算所传输入的费用（不收费），并附上模型 playground 页面的链接
get_balance	查询账户余额，并附上充值链接
list_predictions	运行历史记录（默认最近 24 小时）；可按模型、状态和时间范围筛选
list_billings	列出明细费用和退款（需要 Billing-access 密钥）
get_usage	查询支出、请求数和按模型细分的数据（默认最近 7 天；需要 Billing-access 密钥）
delete_predictions	从历史记录中删除已完成的运行（最多 100 条；需要 confirm: true，删除后无法在此处撤销）
upload_file	本地文件 → 托管 URL（基于内容哈希去重，有效期 24 小时）
get_prediction	按 ID 查询任意运行的状态/输出；可选提供 wait_seconds 等待

五个快捷工具都支持像 run_model 一样使用 wait_seconds；设置 estimate_only: true 会返回价格和即将执行的准确请求，但不会提交任务或收费。在这些工具的提示词中，媒体按给定顺序命名为 @image 1、@video 1、@audio 1；随后会重命名为各模型所需的名称。模型和默认值遵循 /chat：未知的 model 会被拒绝，指定的模型不会被替换。

有些生成任务需要几分钟到几小时。run_model 会提交任务并立即返回预测 ID（done: false）；随后助手会使用该 ID 调用 get_prediction，并传入 wait_seconds（最长 1800），直到 done 为 true。任务会继续在服务端运行，因此连接中断也不会造成任何损失。传入 wait_seconds 可在同一次调用中等待快速模型的运行结果。等待期间，两个工具都会发送携带预测 ID 的 MCP 进度通知。

设置

远程（无需安装）

同一服务托管于：

https://api.wavespeed.ai/mcp

• Claude 网页版 / ChatGPT： 使用该地址添加自定义连接器，并在打开的 WaveSpeed 页面上批准连接。批准后会创建一个专用 API 密钥（名称为 MCP · <app>），你可以在 API Keys 页面删除该密钥以断开连接。
• Claude Code： claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcp
• Cursor：
• VS Code： code --add-mcp '{"name":"wavespeed","type":"http","url":"https://api.wavespeed.ai/mcp"}'
• 任何其他会发送请求标头的客户端： 将其指向该 URL，并设置 Authorization: Bearer <your API key>。

托管服务提供相同的工具，但文件处理有所不同：它无法读取你电脑上的文件，因此请传入公开 URL，使用可发送 HTTP 请求的工具调用 create_upload（它会返回一个临时上传地址，以及可用作输入的 download_url），或者在 ChatGPT 中将文件附加到聊天（upload_attachment 工具只能由 ChatGPT 填入，它会导入文件并返回一个 download_url）。完整指南：wavespeed.ai/docs/mcp。

本地（npx）

@latest 会让 npx 在每次启动时获取最新版本；如果不加它，npx 会运行全局安装的 @wavespeed/mcp（如果存在），不过版本可能较旧。

身份验证会从 WAVESPEED_API_KEY 获取，或使用 CLI 存储的登录信息（wavespeed login）——一次登录即可用于这两种工具。密钥：wavespeed.ai/accesskey。

Claude Code

claude mcp add wavespeed -- npx -y @wavespeed/mcp@latest

Claude Desktop / 其他客户端（mcpServers 配置）：

{
  "mcpServers": {
    "wavespeed": {
      "command": "npx",
      "args": ["-y", "@wavespeed/mcp@latest"],
      "env": { "WAVESPEED_API_KEY": "wsk_..." }
    }
  }
}

示例提示词

• “生成一张 16:9 的赛博朋克天际线主视觉图，呈现金色时刻的氛围。”
• “将 ./photo.jpg 的背景替换为阳光明媚的厨房。”（Agent 会传入 "@./photo.jpg"）
• “为 ./hero.png 添加轻微的视差动画——先查看价格。”

开发

npm install
npm run dev        # run from source (stdio)
npm run lint       # typecheck
npm run build      # tsc → dist/

许可证

MIT

---

WaveSpeed AI — AI 图像与视频生成平台。 在浏览器中试用：图像生成器 · 视频生成器