cloudinary-mcp-server

클라우디너리 MCP 서버

Cloudinary 업로드 및 관리 API 메서드를 AI 어시스턴트의 도구로 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 통합을 통해 AI 시스템이 Cloudinary 클라우드를 트리거하고 상호 작용할 수 있습니다.

작동 원리

MCP 서버:

• Cloudinary API에 귀하를 대신하여 호출합니다.
• Cloudinary에 자산 업로드를 활성화합니다.
• Cloudinary 클라우드에서 자산 관리를 활성화합니다.

이러한 작업을 수행하려면 Cloudinary API를 사용합니다. 모든 메서드와 매개변수가 지원되는 것은 아닙니다. 향후 더 많은 메서드와 매개변수가 추가될 예정입니다.

필요한 경우 특정 방법에 대한 요청으로 이슈를 개설하세요.

이익

• Cloudinary 클라우드 작업을 AI 어시스턴트를 위한 호출 가능한 도구로 전환하세요
• Cloudinary 자산을 AI 어시스턴트를 위한 데이터로 전환하세요

Claude Desktop과 함께 사용

필수 조건

• 노드제이에스
• MCP 클라이언트(Claude Desktop App과 유사)
• Cloudinary API 키/비밀번호를 API 키 에서 생성하고 복사하세요.

설치

Claude Desktop 앱과 함께 이 서버를 사용하려면 claude_desktop_config.json 의 "mcpServers" 섹션에 다음 구성을 추가하세요.

지엑스피1

• CLOUDINARY_CLOUD_NAME - 클라우드 이름
• CLOUDINARY_API_KEY - 클라우드용 API 키
• CLOUDINARY_API_SECRET - 클라우드를 위한 API 비밀

도구

다음과 같은 도구를 사용할 수 있습니다.

1. 업로드하다
   • 설명: Cloudinary에 파일(자산) 업로드
   • 매개변수:
     • source : 업로드할 URL, 파일 경로, base64 콘텐츠 또는 바이너리 데이터
     • folder : Cloudinary의 선택적 폴더 경로
     • publicId : 업로드된 자산에 대한 선택적 공개 ID
     • resourceType : 업로드할 리소스 유형(이미지, 비디오, raw, auto)
     • tags : 자산에 할당할 태그의 쉼표로 구분된 목록
2. 자산 삭제
   • 설명: Cloudinary에서 파일(자산) 삭제
   • 매개변수:
     • publicId : 삭제할 자산의 공개 ID
     • assetId : 삭제할 자산의 자산 ID
3. 자산 가져오기
   • 설명: 특정 파일(자산)의 세부 정보를 가져옵니다.
   • 매개변수:
     • assetId : Cloudinary 자산 ID
     • publicId : 자산의 공개 ID
     • resourceType : 자산 유형(이미지, 원본, 비디오)
     • type : 전송 유형(업로드, 비공개, 인증 등)
     • tags : 태그 이름 목록을 포함할지 여부
     • context : 컨텍스트 메타데이터를 포함할지 여부
     • metadata : 구조화된 메타데이터를 포함할지 여부
4. 자산 찾기
   • 설명: 쿼리 표현식을 사용하여 Cloudinary에서 기존 파일(자산)을 검색합니다.
   • 매개변수:
     • expression : 표현식 검색(예: 'tags=cat' 또는 'public_id:folder/*')
     • resourceType : 리소스 유형(이미지, 비디오, 원시)
     • maxResults : 최대 결과 수(1-500)
     • nextCursor : 페이지 매김을 위한 다음 커서
     • tags : 응답에 태그를 포함합니다.
     • context : 응답에 컨텍스트를 포함합니다.
5. get-usage
   • 설명: 저장소, 크레딧, 대역폭, 요청, 리소스 수, 애드온 사용량을 포함한 제품 환경 사용 상태에 대한 보고서를 받으세요.
   • 매개변수:
     • date : 선택 사항입니다. 사용 보고서의 날짜입니다(yyyy-mm-dd 형식). 최근 3개월 이내여야 합니다. 기본값: 현재 날짜