Placid.app MCP 서버

Placid.app API와 통합하기 위한 MCP 서버 구현입니다. 이 서버는 모델 컨텍스트 프로토콜(MCP)을 통해 템플릿을 나열하고 이미지와 비디오를 생성하는 도구를 제공합니다.

특징

• 필터링 옵션을 사용하여 사용 가능한 Placid 템플릿을 나열합니다.
• 템플릿과 동적 콘텐츠를 사용하여 이미지와 비디오를 생성합니다.
• 안전한 API 토큰 관리
• 오류 처리 및 검증
• 유형 안전 구현

요구 사항: Node.js

1. nodejs.org 에서 Node.js(버전 18 이상)와 npm을 설치하세요.
2. 설치 확인:지엑스피1

설치

빠른 시작(권장)

가장 쉬운 시작 방법은 Smithery를 사용하는 것입니다. Smithery는 모든 것을 자동으로 구성해 줍니다.

수동 구성

수동으로 구성하려면 Claude Desktop 또는 Cline 설정에 다음을 추가하세요.

Placid API 토큰 받기

1. Placid.app 계정에 로그인하세요
2. 설정 > API로 이동하세요
3. "API 토큰 생성"을 클릭하세요
4. 토큰에 이름을 지정하세요(예: "MCP 서버")
5. 생성된 토큰을 복사하세요
6. 위에 표시된 대로 구성에 토큰을 추가하세요.

개발

도구

플래시드_리스트_템플릿

사용 가능한 Placid 템플릿을 필터링 옵션과 함께 나열합니다. 각 템플릿에는 제목, ID, 미리보기 이미지 URL, 사용 가능한 레이어 및 태그가 포함되어 있습니다.

매개변수

• collection_id (선택 사항): 컬렉션 ID로 템플릿 필터링
• custom_data (선택 사항): 사용자 정의 참조 데이터로 필터링
• tags (선택 사항): 템플릿을 필터링할 태그 배열

응답

각 템플릿에 다음이 포함된 배열을 반환합니다.

• uuid : 템플릿의 고유 식별자
• title : 템플릿 이름
• thumbnail : 미리보기 이미지 URL(있는 경우)
• layers : 이름과 유형이 있는 사용 가능한 레이어 배열
• tags : 템플릿 태그 배열

플래시드_제너레이트_비디오

플래시드 템플릿과 비디오, 이미지, 텍스트 등의 동적 콘텐츠를 결합하여 비디오를 제작하세요. 처리 시간이 60초를 초과하는 긴 비디오의 경우, 플래시드 대시보드에서 작업 상태를 확인할 수 있는 작업 ID가 제공됩니다.

매개변수

• template_id (필수): 사용할 템플릿의 UUID
• layers (필수): 템플릿 레이어에 대한 동적 콘텐츠를 포함하는 객체
  • 비디오 레이어의 경우: { "layerName": { "video": "https://video-url.com" } }
  • 이미지 레이어의 경우: { "layerName": { "image": "https://image-url.com" } }
  • 텍스트 레이어의 경우: { "layerName": { "text": "Your content" } }
• audio (선택 사항): mp3 오디오 파일의 URL
• audio_duration (선택 사항): 오디오를 비디오 길이에 맞게 트리밍하려면 'auto'로 설정합니다.
• audio_trim_start (선택 사항): 트림 시작 지점의 타임스탬프(예: '00:00:45' 또는 '00:00:45.25')
• audio_trim_end (선택 사항): 트림 종료 지점의 타임스탬프(예: '00:00:55' 또는 '00:00:55.25')

응답

다음을 포함하는 객체를 반환합니다.

• status : 현재 상태("완료", "대기 중" 또는 "오류")
• video_url : 생성된 비디오를 다운로드할 URL(상태가 "완료"일 때)
• job_id : Placid 대시보드에서 상태를 확인하기 위한 ID(긴 영상의 경우)

LLM 모델에 대한 사용 예

플래시드_생성_이미지

Placid 템플릿을 텍스트와 이미지와 같은 동적 콘텐츠와 결합하여 정적 이미지를 생성합니다.

매개변수

• template_id (필수): 사용할 템플릿의 UUID
• layers (필수): 템플릿 레이어에 대한 동적 콘텐츠를 포함하는 객체
  • 텍스트 레이어의 경우: { "layerName": { "text": "Your content" } }
  • 이미지 레이어의 경우: { "layerName": { "image": "https://image-url.com" } }

응답

다음을 포함하는 객체를 반환합니다.

• status : 완료되면 "완료"
• image_url : 생성된 이미지를 다운로드할 URL

LLM 모델에 대한 사용 예

선적 서류 비치

Placid API에 대한 자세한 내용은 Placid API 문서를 참조하세요.

특허

MIT