클라우디너리 MCP 서버

이 MCP 서버는 Claude Desktop 및 호환되는 MCP 클라이언트를 통해 Cloudinary에 이미지와 비디오를 업로드하기 위한 도구를 제공합니다.

설치

요구 사항: Node.js

1. nodejs.org 에서 Node.js(버전 18 이상)와 npm을 설치하세요.

2. 설치 확인:

   지엑스피1

npx를 사용하여 설치(권장)

1. Claude 구성 디렉토리로 이동합니다.

   • Windows: C:\Users\NAME\AppData\Roaming\Claude

   • macOS: ~/Library/Application Support/Claude/

   Claude Desktop 앱 내부에서도 다음 디렉토리를 찾을 수 있습니다. Claude Desktop > 설정 > 개발자 > 구성 편집

2. MCP 설정 파일에 다음 구성을 추가하세요.

{
  "mcpServers": {
    "cloudinary": {
      "command": "npx",
      "args": ["@felores/cloudinary-mcp-server@latest"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name",
        "CLOUDINARY_API_KEY": "your_api_key",
        "CLOUDINARY_API_SECRET": "your_api_secret"
      }
    }
  }
}

3. Cloudinary 콘솔 의 Cloudinary 자격 증명으로 환경 변수를 바꿔야 합니다.

개발자 설치

서버를 수정하거나 개발에 기여하고 싶다면:

1. 저장소를 복제합니다.

git clone https://github.com/felores/cloudinary-mcp-server.git
cd cloudinary-mcp-server

2. 종속성을 설치하고 빌드합니다.

npm install
npm run build

Related MCP server: cloudinary-mcp-server

설치 지침

1. 먼저 Cloudinary 계정이 있는지 확인하고 Cloudinary 콘솔 에서 자격 증명을 받으세요.

   • 클라우드 이름

   • API 키

   • API 비밀

2. Claude/Cline MCP 설정 파일에 서버 구성을 추가합니다.

{
  "mcpServers": {
    "cloudinary": {
      "command": "node",
      "args": ["c:/path/to/cloudinary-mcp-server/dist/index.js"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name",
        "CLOUDINARY_API_KEY": "your_api_key",
        "CLOUDINARY_API_SECRET": "your_api_secret"
      }
    }
  }
}

Claude 데스크톱 앱의 경우 OS에 맞는 위치에서 구성 파일을 편집하세요.

3. 종속성을 설치하고 서버를 빌드합니다.

npm install
npm run build

사용 가능한 도구

업로드하다

Cloudinary에 이미지와 비디오를 업로드하세요.

매개변수:

• file (필수): 업로드할 파일 경로, URL 또는 base64 데이터 URI

• resource_type (선택 사항): 리소스 유형('image', 'video' 또는 'raw')

• public_id (선택 사항): 업로드된 자산에 대한 사용자 정의 공개 ID

• overwrite (선택 사항): 동일한 공개 ID를 가진 기존 자산을 덮어쓸지 여부

• tags (선택 사항): 업로드된 자산에 할당할 태그 배열

Claude/Cline에서의 사용 예:

use_mcp_tool({
  server_name: "cloudinary",
  tool_name: "upload",
  arguments: {
    file: "path/to/image.jpg",
    resource_type: "image",
    public_id: "my-custom-id"
  }
});