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이 대기 시간 제한에 도달하면 작업은 서버 측에서 계속 실행됩니다. 오류 메시지에 prediction ID가 표시되며, get_prediction으로 이를 확인할 수 있습니다.

Related MCP server: WavespeedMCP

설정

인증은 WAVESPEAK_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