MCP Media Processing Server

MCP 미디어 처리 서버

미디어 처리 작업을 위한 모델 컨텍스트 프로토콜(MCP)을 구현한 Node.js 서버로, 강력한 비디오 및 이미지 조작 기능을 제공합니다.

특징

• 비디오 처리 및 변환
• 이미지 처리 및 조작
• 미디어 압축
• 비디오 트리밍 및 편집
• 이미지 효과 및 워터마킹

필수 조건

이 서버를 사용하기 전에 시스템에 다음 종속성이 설치되어 있는지 확인하세요.

• FFmpeg : 비디오 처리 작업에 필요
  • macOS: brew install ffmpeg
  • 우분투/데비안: sudo apt-get install ffmpeg
  • Windows: FFmpeg 공식 웹사이트 에서 다운로드
• ImageMagick : 이미지 처리 작업에 필요함
  • macOS: brew install imagemagick
  • 우분투/데비안: sudo apt-get install imagemagick
  • Windows: ImageMagick 공식 웹사이트 에서 다운로드

사용 방법

claude_desktop_config.json 에 다음을 추가하세요:

엔피엑스

지엑스피1

API

도구

비디오 운영

• 실행-ffmpeg
  • 사용자 정의 옵션으로 모든 FFmpeg 명령 실행
  • 입력:
    • inputPath (문자열): 입력 비디오 파일의 절대 경로
    • options (문자열[]): FFmpeg 명령 옵션 배열
    • outputPath (문자열, 선택 사항): 출력 파일의 절대 경로
    • outputFilename (문자열, 선택 사항): 출력 파일 이름
• 비디오 변환
  • 비디오를 다른 형식으로 변환
  • 입력:
    • inputPath (문자열): 입력 비디오 파일의 절대 경로
    • outputFormat (문자열): 원하는 출력 형식(예: mp4, mkv, avi)
    • outputPath (문자열, 선택 사항): 사용자 지정 출력 경로
    • outputFilename (문자열, 선택 사항): 사용자 정의 출력 파일 이름
• 비디오 압축
  • 비디오 파일 압축
  • 입력:
    • inputPath (문자열): 입력 비디오 파일의 절대 경로
    • quality (숫자, 선택 사항): 압축 품질(1~51, 낮을수록 품질이 좋음)
    • outputPath (문자열, 선택 사항): 사용자 지정 출력 경로
    • outputFilename (문자열, 선택 사항): 사용자 정의 출력 파일 이름
• 트림 비디오
  • 비디오를 지정된 기간으로 트리밍
  • 입력:
    • inputPath (문자열): 입력 비디오 파일의 절대 경로
    • startTime (문자열): HH 형식의 시작 시간
    • duration (문자열): HH 형식의 지속 시간
    • outputPath (문자열, 선택 사항): 사용자 지정 출력 경로
    • outputFilename (문자열, 선택 사항): 사용자 정의 출력 파일 이름

이미지 작업

• 압축 이미지
  • ImageMagick을 사용하여 PNG 이미지 압축
  • 입력:
    • inputPath (문자열): PNG 이미지 입력에 대한 절대 경로
    • quality (숫자, 선택 사항): 압축 품질(1-100)
    • outputPath (문자열, 선택 사항): 사용자 지정 출력 경로
    • outputFilename (문자열, 선택 사항): 사용자 정의 출력 파일 이름
• 이미지 변환
  • 이미지를 다른 형식으로 변환
  • 입력:
    • inputPath (문자열): 입력 이미지 파일의 절대 경로
    • outputFormat (문자열): 원하는 출력 형식(예: jpg, png, webp, gif)
    • outputPath (문자열, 선택 사항): 사용자 지정 출력 경로
    • outputFilename (문자열, 선택 사항): 사용자 정의 출력 파일 이름
• 이미지 크기 조정
  • 지정된 크기로 이미지 크기 조정
  • 입력:
    • inputPath (문자열): 입력 이미지 파일의 절대 경로
    • width (숫자, 선택 사항): 픽셀 단위의 대상 너비
    • height (숫자, 선택 사항): 픽셀 단위의 대상 높이
    • maintainAspectRatio (부울, 선택 사항): 종횡비를 유지할지 여부
    • outputPath (문자열, 선택 사항): 사용자 지정 출력 경로
    • outputFilename (문자열, 선택 사항): 사용자 정의 출력 파일 이름
• 회전-이미지
  • 지정된 각도로 이미지 회전
  • 입력:
    • inputPath (문자열): 입력 이미지 파일의 절대 경로
    • degrees (숫자): 회전 각도(도)
    • outputPath (문자열, 선택 사항): 사용자 지정 출력 경로
    • outputFilename (문자열, 선택 사항): 사용자 정의 출력 파일 이름
• 워터마크 추가
  • 이미지에 워터마크 추가
  • 입력:
    • inputPath (문자열): 입력 이미지 파일의 절대 경로
    • watermarkPath (문자열): 워터마크 이미지 파일의 절대 경로
    • position (문자열, 선택 사항): 워터마크의 위치(기본값: "southeast")
    • opacity (숫자, 선택 사항): 워터마크 불투명도(0-100)
    • outputPath (문자열, 선택 사항): 사용자 지정 출력 경로
    • outputFilename (문자열, 선택 사항): 사용자 정의 출력 파일 이름
• 적용 효과
  • 이미지에 시각 효과 적용
  • 입력:
    • inputPath (문자열): 입력 이미지 파일의 절대 경로
    • effect (문자열): 적용할 효과(흐림, 선명하게, 가장자리, 엠보싱, 회색조, 세피아, 부정)
    • intensity (숫자, 선택 사항): 효과 강도(0-100)
    • outputPath (문자열, 선택 사항): 사용자 지정 출력 경로
    • outputFilename (문자열, 선택 사항): 사용자 정의 출력 파일 이름

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.