WaveSpeed MCP Server

一个用于 WaveSpeed 平台的 MCP 服务器：在实时目录上运行任何模型——图像、视频、音频、3D——从 Claude Code、Claude Desktop、Cursor、Cline 或任何 MCP 客户端。

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

• 没有硬编码模型。 目录来自实时 API（1 小时缓存）；新平台模型在发布当天即可使用。

• 一个生成动词。 run_model 执行任何操作；get_model_schema 告诉代理模型实际接受哪些输入，因此它会先读取再写入。

• 输入永远不会被修改。 唯一的显式转换是 @path 标记——input 中的 "@./photo.jpg" 值会上传文件并替换为其托管 URL。裸路径会原样传递。

• 诚实的定价。 get_price 在您花费之前报价，并指出报价未覆盖的输入（unpriced_inputs），而不是将公式的下限呈现为“最终”价格。

工具

如果 run_model 达到其等待限制，任务会在服务器端继续运行——错误信息会指明预测 id，get_prediction 可以接续获取。

Related MCP server: WavespeedMCP

设置

身份验证从 WAVESPEED_API_KEY 解析，或从 CLI 存储的登录信息（wavespeed login）解析——一次登录即可覆盖两个工具。密钥：wavespeed.ai/accesskey。

Claude Code

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

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

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

示例提示词

• "生成一张 16:9 的赛博朋克天际线黄金时刻主视觉图。"

• "使用 ./photo.jpg 并将背景替换为阳光充足的厨房。" (代理传递 "@./photo.jpg")

• "为 ./hero.png 制作微妙的视差动画——先检查价格。"

开发

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

许可证

MIT