MCP 도구 및 리소스

이 레퍼런스는 실행 중인 MCP 서버에서 자동 생성됩니다.

워크플로우

AI 에이전트는 파이프라인을 실행하기 위해 다음 워크플로우를 따라야 합니다:

1. list_pipelines — 사용 가능한 파이프라인 탐색
2. get_pipeline_schema — 선택한 파이프라인의 입력 스키마 가져오기
3. request_upload — 필요한 파일 업로드(이미지, 동영상, 오디오)
4. run_pipeline — 필요한 입력으로 파이프라인 실행
5. get_pipeline_run_status — 결과 확인(또는 실시간 알림 대기)

팁

run_pipeline을 호출한 후, 서버는 자동으로 상태 업데이트를 구독합니다. 파이프라인이 pending → running → completed(또는 failed)로 진행됨에 따라 어시스턴트는 notifications/pipeline/status를 수신합니다.

---

도구

list_pipelines

사용 가능한 모든 AI 동영상/이미지 파이프라인을 나열합니다. 각 활성 파이프라인의 이름, 슬러그, 설명, 카테고리, 크레딧 비용, 필요한 공급자를 반환합니다.

매개변수: 없음

---

get_pipeline_schema

특정 파이프라인의 입력 스키마를 가져옵니다. 필수 및 선택 입력 필드를 설명하는 JSON Schema를 반환합니다. 파이프라인을 실행하기 전에 이 도구를 사용하여 어떤 입력이 필요한지 파악하세요.

매개변수:

이름	타입	필수	설명
pipeline_slug	string	예	파이프라인의 슬러그 식별자(예: ‘image-generator’, ‘video-generator’)

---

run_pipeline

주어진 입력으로 슬러그를 통해 AI 파이프라인을 실행합니다. list_pipelines로 사용 가능한 파이프라인을 탐색하고 get_pipeline_schema로 필요한 입력을 확인하세요. 상태 추적을 위한 실행 ID를 반환합니다.

매개변수:

이름	타입	필수	설명
input	object	예	JSON 객체 형태의 파이프라인 입력 필드입니다. get_pipeline_schema를 사용하여 각 파이프라인에 필요한 필드를 확인하세요.
pipeline_slug	string	예	실행할 파이프라인의 슬러그 식별자(예: ‘image-generator’, ‘video-generator’)

---

get_pipeline_run_status

파이프라인 실행의 상태를 확인합니다. 상태(pending/running/completed/failed), 출력 데이터, 오류 메시지, 타임스탬프, 생성된 에셋 URL을 반환합니다.

매개변수:

이름	타입	필수	설명
run_id	string	예	run_pipeline이 반환한 파이프라인 실행 ID

---

request_upload

파일에 대한 사전 서명된 S3 업로드 URL을 요청합니다. 파일 URL이 필요한 파이프라인 입력(예: 이미지, 동영상, 오디오)에 이 도구를 사용하세요.

2단계 업로드 플로우:

1. filename과 content_type으로 이 도구를 호출하여 사전 서명된 업로드 URL과 최종 에셋 URL을 얻습니다
2. 파일 내용을 upload_url로 PUT합니다(사전 서명됨, 5분 후 만료)
3. 파이프라인을 실행할 때 asset_url을 입력 값으로 사용합니다

지원되는 콘텐츠 타입: image/(최대 10MB), video/(최대 50MB), audio/*(최대 20MB)

매개변수:

이름	타입	필수	설명
content_type	string	예	파일의 MIME 타입(예: ‘image/jpeg’, ‘image/png’, ‘video/mp4’, ‘audio/mpeg’)
filename	string	예	업로드할 파일의 이름(예: ‘photo.jpg’, ‘video.mp4’)

---

---

리소스

billing://balance

크레딧 잔액

사용 가능한 크레딧과 예약된 크레딧을 포함한 현재 크레딧 잔액입니다.

MIME 타입: application/json

---

billing://history

크레딧 내역

구매, 사용, 환불을 보여주는 크레딧 거래 내역입니다.

MIME 타입: application/json

---

assets://list

에셋 목록

생성된 에셋(이미지, 동영상, 오디오)을 나열합니다. 파이프라인 실행에서 나온 모든 에셋입니다.

MIME 타입: application/json

---

assets://get/{asset_id}

에셋 가져오기

메타데이터와 다운로드 URL을 포함하여 ID로 특정 에셋의 세부 정보를 가져옵니다.

MIME 타입: application/json

---

assets://list/{type}

타입별 에셋 목록

타입(image, video, audio)별로 필터링된 생성된 에셋을 나열합니다.

MIME 타입: application/json

---

---

실시간 알림

파이프라인을 실행하면 MCP 서버는 자동으로 상태 업데이트를 구독합니다. 알림은 notifications/pipeline/status 메서드를 사용합니다:

{
  "method": "notifications/pipeline/status",
  "params": {
    "run_id": "uuid",
    "status": "completed",
    "pipeline_name": "Pipeline Name",
    "pipeline_slug": "pipeline-slug",
    "assets": [
      {
        "id": "uuid",
        "url": "https://s3.pipe2.ai/assets/...",
        "type": "image"
      }
    ]
  }
}

상태 값: pending, running, completed, failed, cancelled