@ash_j1997/ffmpeg-mcp-server 0.4.2 → 0.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ko.md +120 -0
- package/README.md +37 -23
- package/dist/index.js +283 -91
- package/dist/tools/audio.js +24 -9
- package/dist/tools/burn_subtitles.js +94 -0
- package/dist/tools/compress.js +8 -4
- package/dist/tools/concat.js +14 -3
- package/dist/tools/convert.js +78 -42
- package/dist/tools/keyframes.js +75 -0
- package/dist/tools/normalize.js +75 -0
- package/dist/tools/overlay.js +115 -0
- package/dist/tools/probe.js +6 -2
- package/dist/tools/reformat.js +14 -7
- package/dist/tools/silence.js +81 -20
- package/dist/tools/speed.js +24 -3
- package/dist/tools/split.js +15 -9
- package/dist/tools/subtitles.js +17 -4
- package/dist/tools/thumbnail.js +29 -13
- package/dist/tools/trim.js +47 -14
- package/dist/tools/waveform.js +9 -4
- package/dist/utils/exec.js +139 -8
- package/dist/utils/hwaccel.js +179 -26
- package/package.json +2 -1
package/README.ko.md
ADDED
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
# ffmpeg-mcp-server
|
|
2
|
+
|
|
3
|
+
[English](README.md) | [한국어](README.ko.md)
|
|
4
|
+
|
|
5
|
+
[](https://github.com/Ashutos1997/ffmpeg-mcp-server/actions) [](https://github.com/Ashutos1997/ffmpeg-mcp-server/releases) [](LICENSE) [](https://www.npmjs.com/package/@ash_j1997/ffmpeg-mcp-server) [](https://www.npmjs.com/package/@ash_j1997/ffmpeg-mcp-server) [](https://www.npmjs.com/package/@ash_j1997/ffmpeg-mcp-server) [](https://glama.ai/mcp/servers/@Ashutos1997/ffmpeg-mcp-server) [](https://mcprush.com/to/ashutos1997-ffmpeg-mcp?ref=badge)
|
|
6
|
+
|
|
7
|
+
AI 에이전트와 도구가 로컬에서 비디오 및 오디오를 처리할 수 있도록 FFmpeg 및 FFprobe 기능을 제공하는 Model Context Protocol (MCP) 서버입니다.
|
|
8
|
+
|
|
9
|
+
크로스 플랫폼 GPU 하드웨어 가속(Apple Silicon VideoToolbox, NVIDIA NVENC, Intel QuickSync, AMD AMF), MCP 진행률 토큰을 통한 실시간 진행 상황 보고, `AbortSignal` 기반의 즉각적인 작업 취소, 멀티모달 비전 모델을 위한 이미지 프리뷰 인라인 반환을 완벽하게 지원합니다.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 개발 배경 (Why This Exists)
|
|
14
|
+
|
|
15
|
+
AI 에이전트에게 영상 처리를 직접 명령하면 잘못된 플래그, 문법 오류, 지원되지 않는 픽셀 포맷 등을 만들어내어 작업이 실패하기 쉽습니다.
|
|
16
|
+
|
|
17
|
+
본 서버는 Zod 스키마로 정의된 **17가지 타입 안전한 도구(Typed Tools)**를 제공합니다. AI가 `{ inputPath: "video.mov", preset: "web_mp4" }`와 같은 구조화된 매개변수를 전달하면, 서버가 유효한 FFmpeg 명령어를 로컬에서 직접 실행하며 안정적인 에러 처리, 하드웨어 가속 및 진행률 알림을 수행합니다.
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## 주요 기능 (Key Features)
|
|
22
|
+
|
|
23
|
+
* **범용 하드웨어 가속:** macOS(VideoToolbox), Linux/Windows GPU(NVIDIA NVENC, Intel QuickSync, AMD AMF, VA-API)를 자동 감지하여 낮은 CPU 점유율로 5배~20배 빠른 인코딩을 지원합니다.
|
|
24
|
+
* **실시간 진행률 보고:** 표준 MCP 진행률 토큰(`notifications/progress`)을 통해 실시간 백분율(%)을 전송하여 클라이언트 UI에 진행 바를 표시합니다.
|
|
25
|
+
* **즉각적인 작업 취소:** 클라이언트의 `AbortSignal` 이벤트를 감지하여 사용자가 생성을 중단하면 실행 중인 하위 FFmpeg 프로세스를 즉시 종료합니다.
|
|
26
|
+
* **멀티모달 비전 모델용 프리뷰:** 썸네일, 오디오 파형, 멀티 프레임 콘택트 시트를 base64 이미지 데이터로 인라인 반환하여 Claude 3.7, GPT-4o, Gemini 등의 비전 모델이 미디어를 직접 "볼" 수 있습니다.
|
|
27
|
+
* **숏폼/소셜 포맷 자동화:** 가로 영상을 배경 블러 처리된 9:16 세로 숏폼 영상으로 변환하고, 스타일이 적용된 자막을 하드코딩(버닝)하며, 틱톡/릴스용 상하 분할 스플릿 스크린 영상을 제작합니다.
|
|
28
|
+
* **오디오 엔지니어링:** 스트리밍/방송 표준(EBU R128 / -16 LUFS)에 맞춰 음량을 정규화하고, 80Hz 럼블 제거 필터로 음성을 선명하게 보정하며, 립싱크를 유지하면서 무음 구간을 자동으로 잘라냅니다.
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## 제공 도구 목록 (총 17개)
|
|
33
|
+
|
|
34
|
+
| 도구명 | 설명 | 주요 매개변수 |
|
|
35
|
+
| :--- | :--- | :--- |
|
|
36
|
+
| **`media_probe`** | ffprobe로 미디어 파일을 검사하여 메타데이터, 스트림, 코덱, 해상도, 재생 시간을 JSON으로 반환합니다. | `inputPath` |
|
|
37
|
+
| **`media_convert`** | 비디오 및 오디오 포맷을 변환합니다. 웹용 MP4, WebM, 애니메이션 GIF 프리셋 및 GPU 가속을 지원합니다. | `inputPath`, `outputPath`, `preset`, `crf`, `resolution`, `fps`, `hardwareAcceleration` |
|
|
38
|
+
| **`trim_media`** | 스트림 복사(무손실/초고속) 또는 재인코딩 방식으로 비디오/오디오의 특정 구간을 자릅니다. | `inputPath`, `outputPath`, `startTime`, `endTime`, `duration`, `accurateReencode` |
|
|
39
|
+
| **`extract_audio`** | 비디오에서 오디오 트랙을 추출합니다. Whisper 음성 인식에 최적화된 16kHz 모노 WAV 프리셋을 포함합니다. | `inputPath`, `outputPath`, `format`, `bitrate` |
|
|
40
|
+
| **`extract_thumbnail`** | 특정 타임스탬프 또는 중간 지점의 스틸 컷을 캡처합니다. 비전 모델을 위해 base64 이미지 데이터를 함께 반환할 수 있습니다. | `inputPath`, `outputPath`, `timestamp`, `resolution`, `includeBase64` |
|
|
41
|
+
| **`compress_video`** | 대상 크기(예: GitHub PR용 10MB 미만, Discord용 25MB 미만)에 맞게 비디오를 압축합니다. | `inputPath`, `outputPath`, `targetSizeMB`, `preset`, `crf`, `maxWidth`, `hardwareAcceleration` |
|
|
42
|
+
| **`reformat_aspect_ratio`** | 배경 블러 패딩 또는 중앙 크롭을 적용해 영상 비율을 9:16(세로), 1:1(정사각형), 4:5(포트레이트)로 변환합니다. | `inputPath`, `outputPath`, `targetRatio`, `mode`, `blurAmount`, `padColor`, `hardwareAcceleration` |
|
|
43
|
+
| **`create_split_screen`** | 두 개의 영상을 상하(9:16 숏폼/릴스) 또는 좌우로 배치하고 오디오 믹싱 및 자막을 합성합니다. | `firstVideoPath`, `secondVideoPath`, `outputPath`, `layout`, `audioSource`, `subtitlesPath` |
|
|
44
|
+
| **`trim_silence`** | 영상과 음성의 립싱크를 완벽히 유지하면서 녹음/녹화 영상의 무음 구간(침묵)을 감지해 자동으로 잘라냅니다. | `inputPath`, `outputPath`, `mode`, `thresholdDb`, `minDurationSeconds` |
|
|
45
|
+
| **`concat_media`** | 여러 비디오 또는 오디오 파일을 순서대로 병합합니다. 스트림 복사 및 재인코딩 방식을 지원합니다. | `inputPaths`, `outputPath`, `mode` |
|
|
46
|
+
| **`generate_waveform`** | 오디오 파형(Waveform) PNG 이미지를 생성합니다. 비전 모델을 위한 base64 데이터를 반환할 수 있습니다. | `inputPath`, `outputPath`, `width`, `height`, `color`, `scale`, `includeBase64` |
|
|
47
|
+
| **`add_subtitles`** | 비디오 재인코딩 없이 SRT 또는 VTT 자막 트랙을 MP4/MKV 파일에 소프트웨어 자막으로 삽입합니다. | `videoPath`, `subtitlesPath`, `outputPath`, `language`, `title` |
|
|
48
|
+
| **`burn_subtitles`** *(신규)* | 폰트 크기, 글자 색상, 외곽선, 여백을 커스텀하여 비디오 프레임에 자막을 직접 하드코딩(버닝)합니다. | `videoPath`, `subtitlesPath`, `outputPath`, `fontSize`, `fontColor`, `outlineColor`, `marginV` |
|
|
49
|
+
| **`extract_keyframes`** *(신규)* | 영상 전반에 걸쳐 대표 키프레임을 추출하고 비전 AI가 한눈에 볼 수 있는 그리드형 콘택트 시트를 생성합니다. | `inputPath`, `outputPath`, `count`, `layout`, `includeBase64` |
|
|
50
|
+
| **`normalize_audio`** *(신규)* | EBU R128 표준(기본 -16 LUFS)을 적용해 오디오 음량을 균일하게 정규화하고 80Hz 고역 통과 필터로 음성을 선명하게 다듬습니다. | `inputPath`, `outputPath`, `targetLufs`, `targetPeakDb`, `voiceClarity` |
|
|
51
|
+
| **`add_overlay`** *(신규)* | 워터마크 이미지나 로고 PNG를 영상 모서리에 오버레이하며 위치, 여백, 크기 비율, 투명도를 조절할 수 있습니다. | `videoPath`, `overlayPath`, `outputPath`, `position`, `padding`, `scaleWidth`, `opacity` |
|
|
52
|
+
| **`change_speed`** | 피치(음높이) 왜곡 없이 재생 속도를 배속(2배속 고속, 0.5배속 슬로우 모션 등)으로 조절합니다. | `inputPath`, `outputPath`, `speed`, `muteAudio` |
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## MCP 리소스 및 프롬프트 (Resources & Prompts)
|
|
57
|
+
|
|
58
|
+
### 리소스 (Resources)
|
|
59
|
+
* **`media://capabilities`**: 로컬 FFmpeg 설치 상태, 버전, 감지된 하드웨어 가속기(VideoToolbox, NVENC, QSV, AMF, VAAPI) 및 지원 비디오 인코더를 조회합니다.
|
|
60
|
+
* **`media://presets`**: 소셜 미디어 종횡비, 플랫폼별 업로드 용량 제한, 방송 음량 타깃 기준표를 제공합니다.
|
|
61
|
+
|
|
62
|
+
### 프롬프트 (Prompts)
|
|
63
|
+
* **`social_clip_generator`**: 원본 가로 영상을 블러 패딩, 무음 구간 편집, 자막 버닝이 적용된 세로형 숏폼 클립으로 변환하는 인터랙티브 워크플로우입니다.
|
|
64
|
+
* **`whisper_audio_prep`**: Whisper 음성 인식 모델에 최적화된 16kHz 모노 WAV 오디오 추출 및 음량 정규화 파이프라인입니다.
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## 요구 사항 (Requirements)
|
|
69
|
+
|
|
70
|
+
* **Node.js** >= 18.0.0
|
|
71
|
+
* 로컬에 **FFmpeg & FFprobe** 설치 필요:
|
|
72
|
+
* **macOS:** `brew install ffmpeg`
|
|
73
|
+
* **Linux (Ubuntu/Debian):** `sudo apt update && sudo apt install ffmpeg libass-dev`
|
|
74
|
+
* **Windows:** `winget install Gyan.FFmpeg` 또는 `choco install ffmpeg`
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
78
|
+
## 설치 및 설정 (Installation)
|
|
79
|
+
|
|
80
|
+
### 빠른 시작 (Claude Desktop, Cursor, Antigravity)
|
|
81
|
+
|
|
82
|
+
별도의 저장소 클론이나 빌드 없이 `npx`로 바로 실행할 수 있습니다:
|
|
83
|
+
|
|
84
|
+
```json
|
|
85
|
+
{
|
|
86
|
+
"mcpServers": {
|
|
87
|
+
"ffmpeg": {
|
|
88
|
+
"command": "npx",
|
|
89
|
+
"args": ["-y", "@ash_j1997/ffmpeg-mcp-server"]
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
#### 설정 파일 위치 안내:
|
|
96
|
+
* **Claude Desktop (macOS):** `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
97
|
+
* **Claude Desktop (Windows):** `%APPDATA%\Claude\claude_desktop_config.json`
|
|
98
|
+
* **Antigravity IDE:** `~/.gemini/config/mcp_config.json`
|
|
99
|
+
* **Cursor / Windsurf:** stdio 서버 유형 선택 후 Command: `npx`, Args: `["-y", "@ash_j1997/ffmpeg-mcp-server"]` 추가
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## 로컬 개발 및 테스트 (Local Development)
|
|
104
|
+
|
|
105
|
+
1. **의존성 설치:**
|
|
106
|
+
```bash
|
|
107
|
+
npm install
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
2. **빌드 및 자동화 테스트 실행:**
|
|
111
|
+
```bash
|
|
112
|
+
npm test
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
## 라이선스 (License)
|
|
118
|
+
|
|
119
|
+
MIT © [Ashutos1997](https://github.com/Ashutos1997)
|
|
120
|
+
|
package/README.md
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
# ffmpeg-mcp-server
|
|
2
2
|
|
|
3
|
-
[
|
|
3
|
+
[English](README.md) | [한국어](README.ko.md)
|
|
4
|
+
|
|
5
|
+
[](https://github.com/Ashutos1997/ffmpeg-mcp-server/actions) [](https://github.com/Ashutos1997/ffmpeg-mcp-server/releases) [](LICENSE) [](https://www.npmjs.com/package/@ash_j1997/ffmpeg-mcp-server) [](https://www.npmjs.com/package/@ash_j1997/ffmpeg-mcp-server) [](https://www.npmjs.com/package/@ash_j1997/ffmpeg-mcp-server) [](https://glama.ai/mcp/servers/@Ashutos1997/ffmpeg-mcp-server) [](https://mcprush.com/to/ashutos1997-ffmpeg-mcp?ref=badge)
|
|
4
6
|
|
|
5
7
|
A Model Context Protocol (MCP) server that gives AI tools access to FFmpeg and FFprobe to process video and audio locally.
|
|
6
8
|
|
|
7
|
-
Supports
|
|
9
|
+
Supports cross-platform GPU hardware encoding (Apple Silicon, NVIDIA NVENC, Intel QuickSync, AMD AMF), live progress updates via MCP progress tokens, instant cancellation via `AbortSignal`, and inlines image previews directly for multimodal vision models.
|
|
8
10
|
|
|
9
11
|
---
|
|
10
12
|
|
|
@@ -12,46 +14,63 @@ Supports Apple Silicon hardware encoding and returns image previews directly to
|
|
|
12
14
|
|
|
13
15
|
When AI agents process media, they often hallucinate invalid flags, syntax errors, or incompatible pixel formats.
|
|
14
16
|
|
|
15
|
-
This server provides
|
|
17
|
+
This server provides **17 typed tools** using Zod schemas. The AI passes parameters (such as `{ inputPath: "video.mov", preset: "web_mp4" }`), and the server runs the valid FFmpeg command locally with proper error handling, hardware acceleration, and progress notifications.
|
|
16
18
|
|
|
17
19
|
---
|
|
18
20
|
|
|
19
21
|
## Key Features
|
|
20
22
|
|
|
21
|
-
* **Hardware
|
|
22
|
-
* **
|
|
23
|
-
* **
|
|
24
|
-
* **
|
|
25
|
-
* **
|
|
23
|
+
* **Universal Hardware Acceleration:** Automatically detects and leverages hardware encoders across macOS (VideoToolbox), Linux/Windows GPUs (NVIDIA NVENC, Intel QuickSync, AMD AMF, and VA-API) for 5x–20x faster exports with low CPU usage.
|
|
24
|
+
* **Real-time Progress Reporting:** Emits live percentage updates via standard MCP progress tokens (`notifications/progress`), enabling progress bars in modern AI clients.
|
|
25
|
+
* **Instant Cancellation:** Listens to client `AbortSignal` events to immediately terminate child FFmpeg processes when a generation is stopped.
|
|
26
|
+
* **Multimodal Vision Previews:** Inlines base64 image data for thumbnails, audio waveforms, and multi-frame contact sheets so vision models (Claude 3.7, GPT-4o, Gemini) can "see" media content.
|
|
27
|
+
* **Social Formats & Automation:** Reformats landscape video to 9:16 vertical video with blurred backgrounds, burns customizable hardcoded subtitles, and stacks top/bottom split-screen reels for TikTok and Instagram Reels.
|
|
28
|
+
* **Audio Engineering:** Normalizes loudness to broadcast/streaming standards (EBU R128 / -16 LUFS), cleans vocal audio with 80Hz rumble removal, and trims dead air while preserving lip-sync.
|
|
26
29
|
|
|
27
30
|
---
|
|
28
31
|
|
|
29
|
-
## Included Tools (
|
|
32
|
+
## Included Tools (17 Total)
|
|
30
33
|
|
|
31
34
|
| Tool | Description | Key Parameters |
|
|
32
35
|
| :--- | :--- | :--- |
|
|
33
36
|
| **`media_probe`** | Inspects media files with ffprobe. Returns metadata, streams, codecs, resolution, and duration as JSON. | `inputPath` |
|
|
34
|
-
| **`media_convert`** | Converts video and audio formats. Includes presets for web MP4, WebM, and animated GIF. | `inputPath`, `outputPath`, `preset`, `crf`, `resolution`, `fps`, `hardwareAcceleration` |
|
|
37
|
+
| **`media_convert`** | Converts video and audio formats. Includes presets for web MP4, WebM, and animated GIF with GPU acceleration. | `inputPath`, `outputPath`, `preset`, `crf`, `resolution`, `fps`, `hardwareAcceleration` |
|
|
35
38
|
| **`trim_media`** | Cuts a segment from a video or audio file using stream copy or re-encoding. | `inputPath`, `outputPath`, `startTime`, `endTime`, `duration`, `accurateReencode` |
|
|
36
39
|
| **`extract_audio`** | Rips audio tracks from video. Includes a 16kHz mono WAV preset for Whisper speech recognition. | `inputPath`, `outputPath`, `format`, `bitrate` |
|
|
37
40
|
| **`extract_thumbnail`** | Captures a still image at a timestamp or midpoint. Returns base64 image data for vision models. | `inputPath`, `outputPath`, `timestamp`, `resolution`, `includeBase64` |
|
|
38
41
|
| **`compress_video`** | Compresses video to fit target sizes (such as GitHub PRs under 10MB or Discord under 25MB). | `inputPath`, `outputPath`, `targetSizeMB`, `preset`, `crf`, `maxWidth`, `hardwareAcceleration` |
|
|
39
|
-
| **`reformat_aspect_ratio`** | Changes video ratio to 9:16 vertical, 1:1 square, or 4:5 portrait with blurred borders or center crop. | `inputPath`, `outputPath`, `targetRatio`, `mode`, `blurAmount`, `padColor` |
|
|
42
|
+
| **`reformat_aspect_ratio`** | Changes video ratio to 9:16 vertical, 1:1 square, or 4:5 portrait with blurred borders or center crop. | `inputPath`, `outputPath`, `targetRatio`, `mode`, `blurAmount`, `padColor`, `hardwareAcceleration` |
|
|
40
43
|
| **`create_split_screen`** | Stacks two videos top-and-bottom (9:16 Reels/TikTok) or side-by-side with audio mixing and subtitles. | `firstVideoPath`, `secondVideoPath`, `outputPath`, `layout`, `audioSource`, `subtitlesPath` |
|
|
41
|
-
| **`trim_silence`** | Detects and removes silent pauses from recordings
|
|
44
|
+
| **`trim_silence`** | Detects and removes silent pauses from recordings while preserving video & audio lip-sync. | `inputPath`, `outputPath`, `mode`, `thresholdDb`, `minDurationSeconds` |
|
|
42
45
|
| **`concat_media`** | Joins multiple video or audio files in order using stream copy or re-encoding. | `inputPaths`, `outputPath`, `mode` |
|
|
43
46
|
| **`generate_waveform`** | Generates a PNG waveform image. Returns base64 image data for vision models. | `inputPath`, `outputPath`, `width`, `height`, `color`, `scale`, `includeBase64` |
|
|
44
|
-
| **`add_subtitles`** | Embeds SRT or VTT subtitle tracks into video files without re-encoding video. | `videoPath`, `subtitlesPath`, `outputPath`, `language`, `title` |
|
|
47
|
+
| **`add_subtitles`** | Embeds SRT or VTT subtitle tracks into MP4/MKV video files without re-encoding video. | `videoPath`, `subtitlesPath`, `outputPath`, `language`, `title` |
|
|
48
|
+
| **`burn_subtitles`** *(New)* | Hardcodes subtitles directly onto video frames with customizable font size, colors, and margins. | `videoPath`, `subtitlesPath`, `outputPath`, `fontSize`, `fontColor`, `outlineColor`, `marginV` |
|
|
49
|
+
| **`extract_keyframes`** *(New)* | Extracts multiple representative frames across the video and generates a contact sheet grid for vision AI. | `inputPath`, `outputPath`, `count`, `layout`, `includeBase64` |
|
|
50
|
+
| **`normalize_audio`** *(New)* | Normalizes audio loudness using EBU R128 (default -16 LUFS) with optional speech clarity high-pass filter. | `inputPath`, `outputPath`, `targetLufs`, `targetPeakDb`, `voiceClarity` |
|
|
51
|
+
| **`add_overlay`** *(New)* | Places a watermark image or logo PNG over video with customizable corner position, scale, and opacity. | `videoPath`, `overlayPath`, `outputPath`, `position`, `padding`, `scaleWidth`, `opacity` |
|
|
45
52
|
| **`change_speed`** | Adjusts playback speed (such as 2x fast forward or 0.5x slow motion) with pitch correction. | `inputPath`, `outputPath`, `speed`, `muteAudio` |
|
|
46
53
|
|
|
47
54
|
---
|
|
48
55
|
|
|
56
|
+
## MCP Resources & Prompts
|
|
57
|
+
|
|
58
|
+
### Resources
|
|
59
|
+
* **`media://capabilities`**: Inspects local FFmpeg installation, active version, detected hardware accelerators (VideoToolbox, NVENC, QSV, AMF, VAAPI), and supported video encoders.
|
|
60
|
+
* **`media://presets`**: Standard reference table of social aspect ratios, platform upload file size limits, and broadcast audio loudness targets.
|
|
61
|
+
|
|
62
|
+
### Prompts
|
|
63
|
+
* **`social_clip_generator`**: Interactive workflow that turns raw landscape video into vertical shorts with blurred background padding, trimmed silence, and hardcoded captions.
|
|
64
|
+
* **`whisper_audio_prep`**: Standard pipeline for extracting 16kHz mono WAV audio and normalizing loudness for speech-to-text models.
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
49
68
|
## Requirements
|
|
50
69
|
|
|
51
70
|
* **Node.js** >= 18.0.0
|
|
52
71
|
* **FFmpeg & FFprobe** installed locally:
|
|
53
72
|
* **macOS:** `brew install ffmpeg`
|
|
54
|
-
* **Linux (Ubuntu/Debian):** `sudo apt update && sudo apt install ffmpeg`
|
|
73
|
+
* **Linux (Ubuntu/Debian):** `sudo apt update && sudo apt install ffmpeg libass-dev`
|
|
55
74
|
* **Windows:** `winget install Gyan.FFmpeg` or `choco install ffmpeg`
|
|
56
75
|
|
|
57
76
|
---
|
|
@@ -77,25 +96,20 @@ Run directly with `npx` (no manual cloning or building required):
|
|
|
77
96
|
* **Claude Desktop (macOS):** `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
78
97
|
* **Claude Desktop (Windows):** `%APPDATA%\Claude\claude_desktop_config.json`
|
|
79
98
|
* **Antigravity IDE:** `~/.gemini/config/mcp_config.json`
|
|
80
|
-
* **Cursor / Windsurf:** Add as a stdio server with command `npx` and args `["-y", "@ash_j1997/ffmpeg-mcp-server"]
|
|
99
|
+
* **Cursor / Windsurf:** Add as a stdio server with command `npx` and args `["-y", "@ash_j1997/ffmpeg-mcp-server"]`
|
|
81
100
|
|
|
82
101
|
---
|
|
83
102
|
|
|
84
|
-
## Local Development
|
|
103
|
+
## Local Development & Testing
|
|
85
104
|
|
|
86
105
|
1. **Install dependencies:**
|
|
87
106
|
```bash
|
|
88
107
|
npm install
|
|
89
108
|
```
|
|
90
109
|
|
|
91
|
-
2. **
|
|
92
|
-
```bash
|
|
93
|
-
npm run build
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
3. **Run tests:**
|
|
110
|
+
2. **Run build and automated test suite:**
|
|
97
111
|
```bash
|
|
98
|
-
|
|
112
|
+
npm test
|
|
99
113
|
```
|
|
100
114
|
|
|
101
115
|
---
|