MCP FFmpeg 비디오 프로세서

FFmpeg를 사용하여 비디오 파일을 조작하는 Node.js 서버입니다. 이 서버는 다음과 같은 API를 제공합니다.

• 비디오 크기를 다양한 해상도(360p, 480p, 720p, 1080p)로 조절하세요

• 다양한 포맷(MP3, AAC, WAV, OGG)의 비디오에서 오디오 추출

필수 조건

이 애플리케이션을 실행하기 전에 다음이 설치되어 있어야 합니다.

1. Node.js (v14 이상)

2. FFmpeg - 비디오 처리에 필요합니다.

FFmpeg 설치

macOS에서:

지엑스피1

Ubuntu/Debian의 경우:

sudo apt update
sudo apt install ffmpeg

Windows의 경우:

1. 공식 웹사이트 에서 FFmpeg를 다운로드하세요

2. 파일을 폴더(예: C:\ffmpeg )에 추출합니다.

3. PATH 환경 변수에 bin 폴더를 추가합니다.

Related MCP server: MCP Media Processing Server

설치

1. 이 저장소를 복제하세요:

git clone https://github.com/bitscorp-mcp/mcp-ffmpeg.git
cd mcp-ffmpeg

2. 종속성 설치:

npm install

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 mcp-ffmpeg를 자동으로 설치하려면:

npx -y @smithery/cli install @bitscorp-mcp/mcp-ffmpeg --client claude

서버 실행

다음을 사용하여 서버를 시작합니다.

npm start

파일 변경 시 자동 재시작 기능을 사용하여 개발하는 경우:

npm run dev

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 mcp-ffmpeg를 자동으로 설치하려면:

npx -y @smithery/cli install @bitscorp-mcp/mcp-ffmpeg --client claude

커서용 mcp-ffmpeg를 설치하려면 설정 -> 커서 설정 -> 기능 -> MCP 서버 -> + 추가로 이동하세요.

유형 선택: 명령을 선택하고 Adjust의 API 키를 사용하여 아래를 붙여넣습니다.

npx -y @smithery/cli@latest run @bitscorp/mcp-ffmpeg

Claude Desktop과 함께 사용

이 MCP FFmpeg 서버는 Claude Desktop과 통합되어 자연어 요청을 통해 비디오를 처리할 수 있습니다.

npx로 실행

npx를 사용하여 서버를 직접 실행할 수 있습니다.

npx /path/to/mcp-ffmpeg

또는 npm에 패키지를 게시한 경우:

npx mcp-ffmpeg

Claude Desktop 구성

이 서버를 Claude Desktop에 추가하려면 Claude Desktop 구성 파일을 업데이트하세요.

1. Claude Desktop 구성 파일을 찾으세요.

   • macOS: ~/.config/claude-desktop/config.json 또는 ~/Library/Application Support/Claude Desktop/config.json

   • Windows: %APPDATA%\Claude Desktop\config.json

   • 리눅스: ~/.config/claude-desktop/config.json

2. mcpServers 섹션에 FFmpeg MCP 서버를 추가합니다.

{
    "mcpServers": {
        "ffmpeg": {
            "command": "npx",
            "args": [
                "--yes",
                "/absolute/path/to/mcp-ffmpeg"
            ]
        }
    }
}

npm에 패키지를 게시한 경우:

{
    "mcpServers": {
        "ffmpeg": {
            "command": "npx",
            "args": [
                "--yes",
                "mcp-ffmpeg"
            ]
        }
    }
}

3. 변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.

클로드에 대한 예시 프롬프트

구성이 완료되면 다음과 같은 프롬프트를 사용할 수 있습니다.

Using the ffmpeg MCP server, please resize the video at /path/to/video.mp4 to 720p resolution.

노트

• 업로드된 영상은 uploads 디렉토리에 임시로 저장됩니다.

• 처리된 비디오 및 오디오 파일은 output 디렉토리에 저장됩니다.

• 서버는 업로드 파일 크기를 500MB로 제한합니다.

특허

MIT