프리픽 MCP 서버

Freepik API와 상호 작용하고 스톡 사진과 Mystic AI 이미지 생성 기능에 대한 액세스를 제공하기 위한 MCP 서버 구현입니다.

특징

Freepik 리소스(사진, 벡터, PSD) 검색
자세한 리소스 정보를 얻으세요
리소스 다운로드
Mystic AI를 사용하여 이미지 생성
이미지 생성 상태 확인

Related MCP server: Meilisearch MCP Server

필수 조건

Node.js 18 이상
Freepik API 키( API 설정 가이드 참조)

설치

지엑스피1

구성

먼저 API_SETUP.md 의 지침에 따라 Freepik API 키를 얻으세요.
MCP 설정 파일에 서버를 추가합니다.

{
  "mcpServers": {
    "freepik": {
      "command": "node",
      "args": ["path/to/freepik-mcp/build/index.js"],
      "env": {
        "FREEPIK_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

사용 가능한 도구

검색_리소스

다양한 필터로 Freepik 리소스를 검색하세요:

{
  term?: string;          // Search term
  limit?: number;         // Results per page
  order?: 'relevance' | 'recent';
  filters?: {
    orientation?: {
      landscape?: boolean;
      portrait?: boolean;
      square?: boolean;
      panoramic?: boolean;
    };
    content_type?: {
      photo?: boolean;
      psd?: boolean;
      vector?: boolean;
    };
    license?: {
      freemium?: boolean;
      premium?: boolean;
    };
  };
}

get_resource

특정 리소스에 대한 자세한 정보를 얻으세요:

{
  id: number;  // Resource ID to get details for
}

다운로드 리소스

특정 리소스에 대한 다운로드 URL 가져오기:

{
  id: number;  // Resource ID to download
}

생성_이미지

Freepik Mystic AI를 사용하여 이미지 생성:

{
  prompt: string;         // Text description of the image to generate
  resolution?: '2k' | '4k';
  aspect_ratio?: 'square_1_1' | 'classic_4_3' | 'traditional_3_4' | 
                 'widescreen_16_9' | 'social_story_9_16';
  realism?: boolean;      // Enable realistic style
  engine?: 'automatic' | 'magnific_illusio' | 'magnific_sharpy' | 'magnific_sparkle';
  creative_detailing?: number;  // 0-100
}

체크_상태

Mystic 이미지 생성 작업의 상태를 확인하세요.

{
  task_id: string;  // ID of the generation task to check
}

개발

# Install dependencies
npm install

# Build the server
npm run build

# Run in development mode
npm run dev

오류 처리

서버는 포괄적인 오류 처리를 구현합니다.

API 오류는 자세한 정보와 함께 기록됩니다.
Zod 스키마를 사용한 입력 검증
컨텍스트를 포함한 적절한 오류 응답
속도 제한 인식

기여하다

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

특허

MIT

Freepik MCP Server