capped-video-mcp 0.1.0__tar.gz
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.
- capped_video_mcp-0.1.0/LICENSE +21 -0
- capped_video_mcp-0.1.0/PKG-INFO +195 -0
- capped_video_mcp-0.1.0/README.md +169 -0
- capped_video_mcp-0.1.0/pyproject.toml +71 -0
- capped_video_mcp-0.1.0/pyproject.toml.orig +56 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/__init__.py +19 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/__main__.py +3 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/collector.py +46 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/config.py +363 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/config.toml +153 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/download.py +131 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/ledger.py +347 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/log.py +92 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/policy.py +139 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/preview.py +80 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/providers/__init__.py +3 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/providers/base.py +191 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/providers/fal.py +119 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/providers/mock.py +71 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/providers/replicate.py +115 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/server.py +195 -0
- capped_video_mcp-0.1.0/src/capped_video_mcp/service.py +632 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 임범수
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: capped-video-mcp
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: 영상 생성 모델(Seedance, Kling, Veo 등)을 fal·Replicate 로 부르는 MCP 서버. 비용 상한과 자동 다운로드 포함
|
|
5
|
+
Keywords: mcp,model-context-protocol,capped-videoeration,seedance,fal,replicate,claude
|
|
6
|
+
Author: 임범수
|
|
7
|
+
Author-email: 임범수 <gobslim@daum.net>
|
|
8
|
+
License-Expression: MIT
|
|
9
|
+
License-File: LICENSE
|
|
10
|
+
Classifier: Development Status :: 3 - Alpha
|
|
11
|
+
Classifier: Intended Audience :: Developers
|
|
12
|
+
Classifier: Operating System :: OS Independent
|
|
13
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
14
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
15
|
+
Classifier: Topic :: Multimedia :: Video
|
|
16
|
+
Requires-Dist: anyio>=4.16.0
|
|
17
|
+
Requires-Dist: filelock>=4.2.12
|
|
18
|
+
Requires-Dist: httpx>=0.28.1
|
|
19
|
+
Requires-Dist: mcp[cli]>=2.3.0
|
|
20
|
+
Requires-Dist: pydantic>=2.14.4
|
|
21
|
+
Requires-Dist: python-dotenv>=1.2.4
|
|
22
|
+
Requires-Python: >=3.12
|
|
23
|
+
Project-URL: Homepage, https://github.com/bslim1009/capped-video-mcp
|
|
24
|
+
Project-URL: Issues, https://github.com/bslim1009/capped-video-mcp/issues
|
|
25
|
+
Description-Content-Type: text/markdown
|
|
26
|
+
|
|
27
|
+
# capped-video-mcp
|
|
28
|
+
|
|
29
|
+
영상 생성 모델을 에이전트(Claude Code, Claude Desktop 등)에서 부르는 로컬 MCP 서버. 생성은 **Replicate**와 **fal**을 통해 호출하고, API 키는 각자 자기 것을 쓴다.
|
|
30
|
+
|
|
31
|
+
지원 모델: `seedance-2.5`(Replicate, 기본), `seedance-2.5-fal`, `kling-3.0`, `wan-2.5`, `veo-3.1-fast`, `veo-3.1-lite`, `hailuo-2.3`, `gemini-omni-1.2-flash`. 모델마다 허용 길이·해상도·가격이 다르다(`list_models` 또는 [기본 config.toml](https://github.com/bslim1009/capped-video-mcp/blob/main/src/capped_video_mcp/config.toml)).
|
|
32
|
+
|
|
33
|
+
비용 상한(모델 허용 목록, 해상도·길이, 일일·월간 예산, 동시 작업 수)과 자동 다운로드를 서버가 강제한다.
|
|
34
|
+
|
|
35
|
+
> **알파 단계.** 가격표는 서버가 예산을 계산하는 **예상값**이다(제공처 공시가 기준, 2026-11-22 확인). 실제 청구액은 Replicate·fal 대시보드에서 확인한다. 제공처 API 입력 형식은 공개 스키마와 대조했지만, 실제 생성→다운로드까지의 종단 검증은 아직 진행 중이다. 처음에는 가장 싼 조건(480p 4~5초)으로 시험하고 예산 상한을 낮게 두길 권한다.
|
|
36
|
+
|
|
37
|
+
## 설치와 등록
|
|
38
|
+
|
|
39
|
+
필요한 것: [uv](https://docs.astral.sh/uv/), Replicate 토큰 또는 fal 키 (둘 중 하나만 있어도 된다. 키가 없는 쪽 모델은 꺼진다). 선택: [ffmpeg](https://ffmpeg.org/) (결과 미리보기 `preview_video`에만 쓴다).
|
|
40
|
+
|
|
41
|
+
### Claude Code
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
claude mcp add capped-video --scope user \
|
|
45
|
+
-e FAL_KEY=fal-xxxx \
|
|
46
|
+
-e REPLICATE_API_TOKEN=r8_xxxx \
|
|
47
|
+
-e CAPPED_VIDEO_DEFAULT_MODEL=kling-3.0 \
|
|
48
|
+
-e CAPPED_VIDEO_DAILY_MAX_USD=3 \
|
|
49
|
+
-- uvx capped-video-mcp
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
`--scope user`는 모든 프로젝트에서 쓴다. 팀 저장소에 `.mcp.json`으로 공유할 때는 키를 적지 말고 각자의 환경 변수를 참조한다.
|
|
53
|
+
|
|
54
|
+
```json
|
|
55
|
+
{
|
|
56
|
+
"mcpServers": {
|
|
57
|
+
"capped-video": {
|
|
58
|
+
"command": "uvx",
|
|
59
|
+
"args": ["capped-video-mcp"],
|
|
60
|
+
"env": {
|
|
61
|
+
"FAL_KEY": "${FAL_KEY:-}",
|
|
62
|
+
"REPLICATE_API_TOKEN": "${REPLICATE_API_TOKEN:-}",
|
|
63
|
+
"CAPPED_VIDEO_DEFAULT_MODEL": "kling-3.0"
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
`/mcp`로 연결을 확인한다. `generate_video`는 과금되므로 자동 허용 목록에 넣지 말고 매번 승인하는 것을 권한다.
|
|
71
|
+
|
|
72
|
+
`uvx`는 한 번 받은 버전을 계속 쓴다. 새 버전으로 바꾸려면 `uvx capped-video-mcp@latest`로 등록하거나 `uvx --refresh capped-video-mcp`를 한 번 실행한다.
|
|
73
|
+
|
|
74
|
+
### Claude Desktop 등 다른 클라이언트
|
|
75
|
+
|
|
76
|
+
`claude_desktop_config.json`(또는 각 클라이언트의 MCP 설정)의 `mcpServers`에 위 JSON과 같은 형식으로 넣는다. 키는 `${...}` 대신 값을 직접 쓴다.
|
|
77
|
+
|
|
78
|
+
### 키 없이 시험
|
|
79
|
+
|
|
80
|
+
`CAPPED_VIDEO_PROVIDER=mock`을 함께 넘기면 실제 API를 부르지 않고 가짜 파일을 만든다. 기록도 실제와 분리된다(`data/usage-mock.json`, `<출력 폴더>/mock/`).
|
|
81
|
+
|
|
82
|
+
## 도구
|
|
83
|
+
|
|
84
|
+
| 도구 | 과금 | 하는 일 |
|
|
85
|
+
|---|---|---|
|
|
86
|
+
| `generate_video` | **예** | 생성 작업을 만들고 `job_id`를 돌려준다. `model`, `resolution`, `duration_sec`, `aspect_ratio`를 요청마다 고를 수 있다. **최근 10분 안의 같은 요청은 새 작업을 만들지 않고 기존 `job_id`를 `duplicate: true`로 돌려준다**(과금 없음). `request_id`로도 중복을 잡고, 같은 영상을 하나 더 원할 때만 `force: true` |
|
|
87
|
+
| `get_video_status` | 아니오 | 상태 확인. 최대 60초 기다린다. 완료면 파일 경로 |
|
|
88
|
+
| `download_video` | 아니오 | 자동 다운로드가 실패했을 때 다시 시도 |
|
|
89
|
+
| `get_usage` | 아니오 | 오늘·이번 달 사용량과 상한 |
|
|
90
|
+
| `estimate_video` | 아니오 | 조건(길이·해상도·비율)에 맞는 모델별 예상 비용을 싼 순서로, 남은 예산과 함께. 예산 안에서 가장 싼 모델(`cheapest`), 조건을 못 맞추는 모델과 이유(`unavailable`), 최근 같은 요청(`duplicate_of`) |
|
|
91
|
+
| `preview_video` | 아니오 | 완성된 영상의 프레임 6장을 한 이미지로 붙여 **이미지로** 돌려준다. 에이전트가 결과를 보고 재생성 여부를 판단할 수 있다. ffmpeg 필요(없으면 이유를 돌려줌) |
|
|
92
|
+
| `list_models` | 아니오 | 허용 모델, 가격, 길이 범위, 현재 기본값 |
|
|
93
|
+
|
|
94
|
+
결과 수거는 서버(클라이언트 세션)가 켜져 있는 동안에만 일어난다. 생성 중에는 세션을 닫지 않는다.
|
|
95
|
+
|
|
96
|
+
### 중복 요청 감지
|
|
97
|
+
|
|
98
|
+
에이전트는 응답이 늦거나 애매하면 같은 요청을 다시 보내기 쉽다. 서버는 프롬프트(앞뒤·연속 공백만 정리)·모델·해상도·길이·화면 비율이 같은 요청이 `duplicate_window_minutes`(기본 10분) 안에 다시 오면 제공처를 부르지 않고 기존 작업의 상태를 돌려준다. 과금되지 않은 거부(`create_failed`)와 확정 실패(`failed`)는 다시 시도할 수 있으므로 중복으로 보지 않는다. 검사와 예약이 같은 파일 잠금 안에서 일어나서 두 클라이언트가 동시에 같은 요청을 보내도 하나만 만들어진다. `CAPPED_VIDEO_DUPLICATE_WINDOW_MINUTES=0`으로 끌 수 있다.
|
|
99
|
+
|
|
100
|
+
### 생성 전 비용 확인 (선택)
|
|
101
|
+
|
|
102
|
+
`CAPPED_VIDEO_CONFIRM_ABOVE_USD=0.5`처럼 임계값을 주면, 예상 비용이 그 이상일 때 **서버가** 클라이언트에 "약 $0.63이 과금됩니다. 진행할까요?"를 직접 묻는다(MCP elicitation). 클라이언트의 도구 승인 설정과 무관하게 동작하므로, 자동 승인 모드에서도 비싼 생성은 한 번 더 확인받을 수 있다. 클라이언트가 이 요청을 지원하지 않으면 `CAPPED_VIDEO_CONFIRM_FALLBACK`(`allow` 기본: 그냥 진행, `deny`: 거부)을 따른다. 기본값 0은 묻지 않는다.
|
|
103
|
+
|
|
104
|
+
### 제공처 전환
|
|
105
|
+
|
|
106
|
+
같은 모델이 두 제공처에 있으면(`seedance-2.5` ↔ `seedance-2.5-fal`) 1차 제공처가 요청을 **확정 거부**(4xx, 점검 등)했을 때 남은 예산을 다시 확인하고 대체 모델로 만든다. 응답에 `failover_from`이 붙는다. 결과를 알 수 없는 오류(타임아웃, 5xx)에서는 과금됐을 수 있으므로 전환하지 않는다. `CAPPED_VIDEO_FAILOVER=false`로 끈다. 대체 모델은 설정의 `fallback_model`로 바꿀 수 있다.
|
|
107
|
+
|
|
108
|
+
### 결과 미리보기
|
|
109
|
+
|
|
110
|
+
`preview_video`는 ffmpeg로 프레임 6장(가로 3장 × 2줄, 시간 순서)을 한 JPEG로 붙여 이미지 콘텐츠로 돌려준다. 결과는 영상 옆에 `<job_id>.preview.jpg`로 저장해 다시 만들지 않는다. ffmpeg는 PATH 또는 `CAPPED_VIDEO_FFMPEG`로 찾고, 없으면 영상 경로와 함께 이유만 돌려준다. 장수·가로 크기는 설정 `[preview]`에서 바꾼다.
|
|
111
|
+
|
|
112
|
+
## 설정
|
|
113
|
+
|
|
114
|
+
설정은 아래 순서로 덮어쓴다. 뒤에 있는 것이 이긴다.
|
|
115
|
+
|
|
116
|
+
1. 패키지 기본값 [src/capped_video_mcp/config.toml](https://github.com/bslim1009/capped-video-mcp/blob/main/src/capped_video_mcp/config.toml)
|
|
117
|
+
2. 데이터 폴더의 `config.toml` (있으면. 바꿀 항목만 쓴다)
|
|
118
|
+
3. `CAPPED_VIDEO_*` 환경 변수 (등록 때 `-e`/`env`로 넘기거나 데이터 폴더의 `.env`)
|
|
119
|
+
|
|
120
|
+
### 환경 변수
|
|
121
|
+
|
|
122
|
+
| 변수 | 설정 위치 | 예 |
|
|
123
|
+
|---|---|---|
|
|
124
|
+
| `FAL_KEY` | fal API 키 (API 범위, ADMIN 범위 쓰지 않기) | |
|
|
125
|
+
| `REPLICATE_API_TOKEN` | Replicate 토큰 | |
|
|
126
|
+
| `CAPPED_VIDEO_DEFAULT_MODEL` | `defaults.model` | `kling-3.0` |
|
|
127
|
+
| `CAPPED_VIDEO_DEFAULT_RESOLUTION` | `defaults.resolution` | `480p` |
|
|
128
|
+
| `CAPPED_VIDEO_DEFAULT_DURATION_SEC` | `defaults.duration_sec` | `5` |
|
|
129
|
+
| `CAPPED_VIDEO_DEFAULT_ASPECT_RATIO` | `defaults.aspect_ratio` | `9:16` |
|
|
130
|
+
| `CAPPED_VIDEO_MAX_RESOLUTION` | `limits.max_resolution` | `720p` |
|
|
131
|
+
| `CAPPED_VIDEO_MAX_DURATION_SEC` | `limits.max_duration_sec` | `10` |
|
|
132
|
+
| `CAPPED_VIDEO_DAILY_MAX_COUNT` | `limits.daily_max_count` | `10` |
|
|
133
|
+
| `CAPPED_VIDEO_DAILY_MAX_USD` | `limits.daily_max_usd` | `5` |
|
|
134
|
+
| `CAPPED_VIDEO_MONTHLY_MAX_USD` | `limits.monthly_max_usd` | `30` |
|
|
135
|
+
| `CAPPED_VIDEO_MAX_PENDING_JOBS` | `limits.max_pending_jobs` | `3` |
|
|
136
|
+
| `CAPPED_VIDEO_DUPLICATE_WINDOW_MINUTES` | `limits.duplicate_window_minutes` (같은 요청을 중복으로 보는 시간. `0`이면 끔) | `10` |
|
|
137
|
+
| `CAPPED_VIDEO_CONFIRM_ABOVE_USD` | `limits.confirm_above_usd` (이 금액 이상이면 생성 전 사용자 확인. `0`이면 끔) | `0.5` |
|
|
138
|
+
| `CAPPED_VIDEO_CONFIRM_FALLBACK` | `limits.confirm_fallback` (확인을 지원하지 않는 클라이언트: `allow`/`deny`) | `allow` |
|
|
139
|
+
| `CAPPED_VIDEO_FAILOVER` | `limits.failover` (확정 거부 시 `fallback_model`로 전환) | `true` |
|
|
140
|
+
| `CAPPED_VIDEO_FFMPEG` | `preview.ffmpeg` (미리보기용 ffmpeg 경로. 비우면 PATH) | `C:/ffmpeg/bin/ffmpeg.exe` |
|
|
141
|
+
| `CAPPED_VIDEO_OUTPUT_DIR` | `download.dir` (영상 저장 폴더. 상대 경로면 데이터 폴더 기준) | `~/Videos/capped-video` |
|
|
142
|
+
| `CAPPED_VIDEO_HOME` | 데이터 폴더 위치. **절대 경로**, 등록 env로만 (`.env`에 쓰면 효과 없음) | `D:/capped-video` |
|
|
143
|
+
| `CAPPED_VIDEO_PROVIDER` | `mock`이면 실제 API를 부르지 않는다. 다른 값은 오류 | `mock` |
|
|
144
|
+
|
|
145
|
+
빈 값은 없는 것으로 본다(`.env`에 값이 있으면 그 값을 쓴다). 값이 잘못되면(없는 모델, 모르는 해상도, 숫자가 아닌 예산 등) 서버가 뜨지 않고 어떤 변수·파일이 문제인지 알려 준다. 경로에는 `~`와 환경 변수(`%USERPROFILE%`, `$HOME`)를 쓸 수 있다. API 키를 도구 인자나 대화로 넘기지 않는다(대화 기록과 로그에 남는다).
|
|
146
|
+
|
|
147
|
+
### 데이터 폴더
|
|
148
|
+
|
|
149
|
+
| 실행 방식 | 위치 |
|
|
150
|
+
|---|---|
|
|
151
|
+
| `CAPPED_VIDEO_HOME` 지정 | 그 폴더 |
|
|
152
|
+
| `uvx`·`pip` 설치 | `~/.capped-video-mcp` (Windows: `C:\Users\<이름>\.capped-video-mcp`) |
|
|
153
|
+
| 이 저장소에서 `uv sync` 후 실행 | 저장소 루트 |
|
|
154
|
+
|
|
155
|
+
안에 생기는 것: `config.toml`·`.env`(선택, 직접 만든다), `output/`(영상), `data/usage.json`(사용량 기록), `logs/`.
|
|
156
|
+
|
|
157
|
+
데이터 폴더 `config.toml` 예. 표(`[limits]` 등)는 쓴 키만 바뀌고, 목록(`[[models]]`, `allowed_hosts`)은 통째로 바뀐다.
|
|
158
|
+
|
|
159
|
+
```toml
|
|
160
|
+
[defaults]
|
|
161
|
+
model = "veo-3.1-lite"
|
|
162
|
+
|
|
163
|
+
[limits]
|
|
164
|
+
daily_max_usd = 2.0
|
|
165
|
+
|
|
166
|
+
[download]
|
|
167
|
+
dir = 'D:\Videos\capped-video' # Windows 경로는 작은따옴표 또는 / 로 쓴다
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
## 개발
|
|
171
|
+
|
|
172
|
+
```bash
|
|
173
|
+
uv sync
|
|
174
|
+
cp .env.example .env # 키를 채운다. 키 없이 시험하려면 CAPPED_VIDEO_PROVIDER=mock
|
|
175
|
+
uv run pytest # 실제 API 를 부르지 않는다
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
저장소에서 띄우려면 `.mcp.json`(git 제외)에 등록한다.
|
|
179
|
+
|
|
180
|
+
```json
|
|
181
|
+
{
|
|
182
|
+
"mcpServers": {
|
|
183
|
+
"capped-video": {
|
|
184
|
+
"command": "uv",
|
|
185
|
+
"args": ["run", "--directory", "<저장소 경로>", "python", "-m", "capped_video_mcp"]
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
배포 절차는 [doc/배포가이드.md](https://github.com/bslim1009/capped-video-mcp/blob/main/doc/배포가이드.md), 작업 경과는 [doc/작업진행.md](https://github.com/bslim1009/capped-video-mcp/blob/main/doc/작업진행.md)에 있다.
|
|
192
|
+
|
|
193
|
+
## 라이선스
|
|
194
|
+
|
|
195
|
+
MIT
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
# capped-video-mcp
|
|
2
|
+
|
|
3
|
+
영상 생성 모델을 에이전트(Claude Code, Claude Desktop 등)에서 부르는 로컬 MCP 서버. 생성은 **Replicate**와 **fal**을 통해 호출하고, API 키는 각자 자기 것을 쓴다.
|
|
4
|
+
|
|
5
|
+
지원 모델: `seedance-2.5`(Replicate, 기본), `seedance-2.5-fal`, `kling-3.0`, `wan-2.5`, `veo-3.1-fast`, `veo-3.1-lite`, `hailuo-2.3`, `gemini-omni-1.2-flash`. 모델마다 허용 길이·해상도·가격이 다르다(`list_models` 또는 [기본 config.toml](https://github.com/bslim1009/capped-video-mcp/blob/main/src/capped_video_mcp/config.toml)).
|
|
6
|
+
|
|
7
|
+
비용 상한(모델 허용 목록, 해상도·길이, 일일·월간 예산, 동시 작업 수)과 자동 다운로드를 서버가 강제한다.
|
|
8
|
+
|
|
9
|
+
> **알파 단계.** 가격표는 서버가 예산을 계산하는 **예상값**이다(제공처 공시가 기준, 2026-11-22 확인). 실제 청구액은 Replicate·fal 대시보드에서 확인한다. 제공처 API 입력 형식은 공개 스키마와 대조했지만, 실제 생성→다운로드까지의 종단 검증은 아직 진행 중이다. 처음에는 가장 싼 조건(480p 4~5초)으로 시험하고 예산 상한을 낮게 두길 권한다.
|
|
10
|
+
|
|
11
|
+
## 설치와 등록
|
|
12
|
+
|
|
13
|
+
필요한 것: [uv](https://docs.astral.sh/uv/), Replicate 토큰 또는 fal 키 (둘 중 하나만 있어도 된다. 키가 없는 쪽 모델은 꺼진다). 선택: [ffmpeg](https://ffmpeg.org/) (결과 미리보기 `preview_video`에만 쓴다).
|
|
14
|
+
|
|
15
|
+
### Claude Code
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
claude mcp add capped-video --scope user \
|
|
19
|
+
-e FAL_KEY=fal-xxxx \
|
|
20
|
+
-e REPLICATE_API_TOKEN=r8_xxxx \
|
|
21
|
+
-e CAPPED_VIDEO_DEFAULT_MODEL=kling-3.0 \
|
|
22
|
+
-e CAPPED_VIDEO_DAILY_MAX_USD=3 \
|
|
23
|
+
-- uvx capped-video-mcp
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
`--scope user`는 모든 프로젝트에서 쓴다. 팀 저장소에 `.mcp.json`으로 공유할 때는 키를 적지 말고 각자의 환경 변수를 참조한다.
|
|
27
|
+
|
|
28
|
+
```json
|
|
29
|
+
{
|
|
30
|
+
"mcpServers": {
|
|
31
|
+
"capped-video": {
|
|
32
|
+
"command": "uvx",
|
|
33
|
+
"args": ["capped-video-mcp"],
|
|
34
|
+
"env": {
|
|
35
|
+
"FAL_KEY": "${FAL_KEY:-}",
|
|
36
|
+
"REPLICATE_API_TOKEN": "${REPLICATE_API_TOKEN:-}",
|
|
37
|
+
"CAPPED_VIDEO_DEFAULT_MODEL": "kling-3.0"
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
`/mcp`로 연결을 확인한다. `generate_video`는 과금되므로 자동 허용 목록에 넣지 말고 매번 승인하는 것을 권한다.
|
|
45
|
+
|
|
46
|
+
`uvx`는 한 번 받은 버전을 계속 쓴다. 새 버전으로 바꾸려면 `uvx capped-video-mcp@latest`로 등록하거나 `uvx --refresh capped-video-mcp`를 한 번 실행한다.
|
|
47
|
+
|
|
48
|
+
### Claude Desktop 등 다른 클라이언트
|
|
49
|
+
|
|
50
|
+
`claude_desktop_config.json`(또는 각 클라이언트의 MCP 설정)의 `mcpServers`에 위 JSON과 같은 형식으로 넣는다. 키는 `${...}` 대신 값을 직접 쓴다.
|
|
51
|
+
|
|
52
|
+
### 키 없이 시험
|
|
53
|
+
|
|
54
|
+
`CAPPED_VIDEO_PROVIDER=mock`을 함께 넘기면 실제 API를 부르지 않고 가짜 파일을 만든다. 기록도 실제와 분리된다(`data/usage-mock.json`, `<출력 폴더>/mock/`).
|
|
55
|
+
|
|
56
|
+
## 도구
|
|
57
|
+
|
|
58
|
+
| 도구 | 과금 | 하는 일 |
|
|
59
|
+
|---|---|---|
|
|
60
|
+
| `generate_video` | **예** | 생성 작업을 만들고 `job_id`를 돌려준다. `model`, `resolution`, `duration_sec`, `aspect_ratio`를 요청마다 고를 수 있다. **최근 10분 안의 같은 요청은 새 작업을 만들지 않고 기존 `job_id`를 `duplicate: true`로 돌려준다**(과금 없음). `request_id`로도 중복을 잡고, 같은 영상을 하나 더 원할 때만 `force: true` |
|
|
61
|
+
| `get_video_status` | 아니오 | 상태 확인. 최대 60초 기다린다. 완료면 파일 경로 |
|
|
62
|
+
| `download_video` | 아니오 | 자동 다운로드가 실패했을 때 다시 시도 |
|
|
63
|
+
| `get_usage` | 아니오 | 오늘·이번 달 사용량과 상한 |
|
|
64
|
+
| `estimate_video` | 아니오 | 조건(길이·해상도·비율)에 맞는 모델별 예상 비용을 싼 순서로, 남은 예산과 함께. 예산 안에서 가장 싼 모델(`cheapest`), 조건을 못 맞추는 모델과 이유(`unavailable`), 최근 같은 요청(`duplicate_of`) |
|
|
65
|
+
| `preview_video` | 아니오 | 완성된 영상의 프레임 6장을 한 이미지로 붙여 **이미지로** 돌려준다. 에이전트가 결과를 보고 재생성 여부를 판단할 수 있다. ffmpeg 필요(없으면 이유를 돌려줌) |
|
|
66
|
+
| `list_models` | 아니오 | 허용 모델, 가격, 길이 범위, 현재 기본값 |
|
|
67
|
+
|
|
68
|
+
결과 수거는 서버(클라이언트 세션)가 켜져 있는 동안에만 일어난다. 생성 중에는 세션을 닫지 않는다.
|
|
69
|
+
|
|
70
|
+
### 중복 요청 감지
|
|
71
|
+
|
|
72
|
+
에이전트는 응답이 늦거나 애매하면 같은 요청을 다시 보내기 쉽다. 서버는 프롬프트(앞뒤·연속 공백만 정리)·모델·해상도·길이·화면 비율이 같은 요청이 `duplicate_window_minutes`(기본 10분) 안에 다시 오면 제공처를 부르지 않고 기존 작업의 상태를 돌려준다. 과금되지 않은 거부(`create_failed`)와 확정 실패(`failed`)는 다시 시도할 수 있으므로 중복으로 보지 않는다. 검사와 예약이 같은 파일 잠금 안에서 일어나서 두 클라이언트가 동시에 같은 요청을 보내도 하나만 만들어진다. `CAPPED_VIDEO_DUPLICATE_WINDOW_MINUTES=0`으로 끌 수 있다.
|
|
73
|
+
|
|
74
|
+
### 생성 전 비용 확인 (선택)
|
|
75
|
+
|
|
76
|
+
`CAPPED_VIDEO_CONFIRM_ABOVE_USD=0.5`처럼 임계값을 주면, 예상 비용이 그 이상일 때 **서버가** 클라이언트에 "약 $0.63이 과금됩니다. 진행할까요?"를 직접 묻는다(MCP elicitation). 클라이언트의 도구 승인 설정과 무관하게 동작하므로, 자동 승인 모드에서도 비싼 생성은 한 번 더 확인받을 수 있다. 클라이언트가 이 요청을 지원하지 않으면 `CAPPED_VIDEO_CONFIRM_FALLBACK`(`allow` 기본: 그냥 진행, `deny`: 거부)을 따른다. 기본값 0은 묻지 않는다.
|
|
77
|
+
|
|
78
|
+
### 제공처 전환
|
|
79
|
+
|
|
80
|
+
같은 모델이 두 제공처에 있으면(`seedance-2.5` ↔ `seedance-2.5-fal`) 1차 제공처가 요청을 **확정 거부**(4xx, 점검 등)했을 때 남은 예산을 다시 확인하고 대체 모델로 만든다. 응답에 `failover_from`이 붙는다. 결과를 알 수 없는 오류(타임아웃, 5xx)에서는 과금됐을 수 있으므로 전환하지 않는다. `CAPPED_VIDEO_FAILOVER=false`로 끈다. 대체 모델은 설정의 `fallback_model`로 바꿀 수 있다.
|
|
81
|
+
|
|
82
|
+
### 결과 미리보기
|
|
83
|
+
|
|
84
|
+
`preview_video`는 ffmpeg로 프레임 6장(가로 3장 × 2줄, 시간 순서)을 한 JPEG로 붙여 이미지 콘텐츠로 돌려준다. 결과는 영상 옆에 `<job_id>.preview.jpg`로 저장해 다시 만들지 않는다. ffmpeg는 PATH 또는 `CAPPED_VIDEO_FFMPEG`로 찾고, 없으면 영상 경로와 함께 이유만 돌려준다. 장수·가로 크기는 설정 `[preview]`에서 바꾼다.
|
|
85
|
+
|
|
86
|
+
## 설정
|
|
87
|
+
|
|
88
|
+
설정은 아래 순서로 덮어쓴다. 뒤에 있는 것이 이긴다.
|
|
89
|
+
|
|
90
|
+
1. 패키지 기본값 [src/capped_video_mcp/config.toml](https://github.com/bslim1009/capped-video-mcp/blob/main/src/capped_video_mcp/config.toml)
|
|
91
|
+
2. 데이터 폴더의 `config.toml` (있으면. 바꿀 항목만 쓴다)
|
|
92
|
+
3. `CAPPED_VIDEO_*` 환경 변수 (등록 때 `-e`/`env`로 넘기거나 데이터 폴더의 `.env`)
|
|
93
|
+
|
|
94
|
+
### 환경 변수
|
|
95
|
+
|
|
96
|
+
| 변수 | 설정 위치 | 예 |
|
|
97
|
+
|---|---|---|
|
|
98
|
+
| `FAL_KEY` | fal API 키 (API 범위, ADMIN 범위 쓰지 않기) | |
|
|
99
|
+
| `REPLICATE_API_TOKEN` | Replicate 토큰 | |
|
|
100
|
+
| `CAPPED_VIDEO_DEFAULT_MODEL` | `defaults.model` | `kling-3.0` |
|
|
101
|
+
| `CAPPED_VIDEO_DEFAULT_RESOLUTION` | `defaults.resolution` | `480p` |
|
|
102
|
+
| `CAPPED_VIDEO_DEFAULT_DURATION_SEC` | `defaults.duration_sec` | `5` |
|
|
103
|
+
| `CAPPED_VIDEO_DEFAULT_ASPECT_RATIO` | `defaults.aspect_ratio` | `9:16` |
|
|
104
|
+
| `CAPPED_VIDEO_MAX_RESOLUTION` | `limits.max_resolution` | `720p` |
|
|
105
|
+
| `CAPPED_VIDEO_MAX_DURATION_SEC` | `limits.max_duration_sec` | `10` |
|
|
106
|
+
| `CAPPED_VIDEO_DAILY_MAX_COUNT` | `limits.daily_max_count` | `10` |
|
|
107
|
+
| `CAPPED_VIDEO_DAILY_MAX_USD` | `limits.daily_max_usd` | `5` |
|
|
108
|
+
| `CAPPED_VIDEO_MONTHLY_MAX_USD` | `limits.monthly_max_usd` | `30` |
|
|
109
|
+
| `CAPPED_VIDEO_MAX_PENDING_JOBS` | `limits.max_pending_jobs` | `3` |
|
|
110
|
+
| `CAPPED_VIDEO_DUPLICATE_WINDOW_MINUTES` | `limits.duplicate_window_minutes` (같은 요청을 중복으로 보는 시간. `0`이면 끔) | `10` |
|
|
111
|
+
| `CAPPED_VIDEO_CONFIRM_ABOVE_USD` | `limits.confirm_above_usd` (이 금액 이상이면 생성 전 사용자 확인. `0`이면 끔) | `0.5` |
|
|
112
|
+
| `CAPPED_VIDEO_CONFIRM_FALLBACK` | `limits.confirm_fallback` (확인을 지원하지 않는 클라이언트: `allow`/`deny`) | `allow` |
|
|
113
|
+
| `CAPPED_VIDEO_FAILOVER` | `limits.failover` (확정 거부 시 `fallback_model`로 전환) | `true` |
|
|
114
|
+
| `CAPPED_VIDEO_FFMPEG` | `preview.ffmpeg` (미리보기용 ffmpeg 경로. 비우면 PATH) | `C:/ffmpeg/bin/ffmpeg.exe` |
|
|
115
|
+
| `CAPPED_VIDEO_OUTPUT_DIR` | `download.dir` (영상 저장 폴더. 상대 경로면 데이터 폴더 기준) | `~/Videos/capped-video` |
|
|
116
|
+
| `CAPPED_VIDEO_HOME` | 데이터 폴더 위치. **절대 경로**, 등록 env로만 (`.env`에 쓰면 효과 없음) | `D:/capped-video` |
|
|
117
|
+
| `CAPPED_VIDEO_PROVIDER` | `mock`이면 실제 API를 부르지 않는다. 다른 값은 오류 | `mock` |
|
|
118
|
+
|
|
119
|
+
빈 값은 없는 것으로 본다(`.env`에 값이 있으면 그 값을 쓴다). 값이 잘못되면(없는 모델, 모르는 해상도, 숫자가 아닌 예산 등) 서버가 뜨지 않고 어떤 변수·파일이 문제인지 알려 준다. 경로에는 `~`와 환경 변수(`%USERPROFILE%`, `$HOME`)를 쓸 수 있다. API 키를 도구 인자나 대화로 넘기지 않는다(대화 기록과 로그에 남는다).
|
|
120
|
+
|
|
121
|
+
### 데이터 폴더
|
|
122
|
+
|
|
123
|
+
| 실행 방식 | 위치 |
|
|
124
|
+
|---|---|
|
|
125
|
+
| `CAPPED_VIDEO_HOME` 지정 | 그 폴더 |
|
|
126
|
+
| `uvx`·`pip` 설치 | `~/.capped-video-mcp` (Windows: `C:\Users\<이름>\.capped-video-mcp`) |
|
|
127
|
+
| 이 저장소에서 `uv sync` 후 실행 | 저장소 루트 |
|
|
128
|
+
|
|
129
|
+
안에 생기는 것: `config.toml`·`.env`(선택, 직접 만든다), `output/`(영상), `data/usage.json`(사용량 기록), `logs/`.
|
|
130
|
+
|
|
131
|
+
데이터 폴더 `config.toml` 예. 표(`[limits]` 등)는 쓴 키만 바뀌고, 목록(`[[models]]`, `allowed_hosts`)은 통째로 바뀐다.
|
|
132
|
+
|
|
133
|
+
```toml
|
|
134
|
+
[defaults]
|
|
135
|
+
model = "veo-3.1-lite"
|
|
136
|
+
|
|
137
|
+
[limits]
|
|
138
|
+
daily_max_usd = 2.0
|
|
139
|
+
|
|
140
|
+
[download]
|
|
141
|
+
dir = 'D:\Videos\capped-video' # Windows 경로는 작은따옴표 또는 / 로 쓴다
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
## 개발
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
uv sync
|
|
148
|
+
cp .env.example .env # 키를 채운다. 키 없이 시험하려면 CAPPED_VIDEO_PROVIDER=mock
|
|
149
|
+
uv run pytest # 실제 API 를 부르지 않는다
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
저장소에서 띄우려면 `.mcp.json`(git 제외)에 등록한다.
|
|
153
|
+
|
|
154
|
+
```json
|
|
155
|
+
{
|
|
156
|
+
"mcpServers": {
|
|
157
|
+
"capped-video": {
|
|
158
|
+
"command": "uv",
|
|
159
|
+
"args": ["run", "--directory", "<저장소 경로>", "python", "-m", "capped_video_mcp"]
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
배포 절차는 [doc/배포가이드.md](https://github.com/bslim1009/capped-video-mcp/blob/main/doc/배포가이드.md), 작업 경과는 [doc/작업진행.md](https://github.com/bslim1009/capped-video-mcp/blob/main/doc/작업진행.md)에 있다.
|
|
166
|
+
|
|
167
|
+
## 라이선스
|
|
168
|
+
|
|
169
|
+
MIT
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "capped-video-mcp"
|
|
3
|
+
version = "0.1.0"
|
|
4
|
+
description = "영상 생성 모델(Seedance, Kling, Veo 등)을 fal·Replicate 로 부르는 MCP 서버. 비용 상한과 자동 다운로드 포함"
|
|
5
|
+
readme = "README.md"
|
|
6
|
+
license = "MIT"
|
|
7
|
+
license-files = ["LICENSE"]
|
|
8
|
+
keywords = [
|
|
9
|
+
"mcp",
|
|
10
|
+
"model-context-protocol",
|
|
11
|
+
"capped-videoeration",
|
|
12
|
+
"seedance",
|
|
13
|
+
"fal",
|
|
14
|
+
"replicate",
|
|
15
|
+
"claude",
|
|
16
|
+
]
|
|
17
|
+
classifiers = [
|
|
18
|
+
"Development Status :: 3 - Alpha",
|
|
19
|
+
"Intended Audience :: Developers",
|
|
20
|
+
"Operating System :: OS Independent",
|
|
21
|
+
"Programming Language :: Python :: 3 :: Only",
|
|
22
|
+
"Programming Language :: Python :: 3.12",
|
|
23
|
+
"Topic :: Multimedia :: Video",
|
|
24
|
+
]
|
|
25
|
+
requires-python = ">=3.12"
|
|
26
|
+
dependencies = [
|
|
27
|
+
"anyio>=4.16.0",
|
|
28
|
+
"filelock>=4.2.12",
|
|
29
|
+
"httpx>=0.28.1",
|
|
30
|
+
"mcp[cli]>=2.3.0",
|
|
31
|
+
"pydantic>=2.14.4",
|
|
32
|
+
"python-dotenv>=1.2.4",
|
|
33
|
+
]
|
|
34
|
+
|
|
35
|
+
[[project.authors]]
|
|
36
|
+
name = "임범수"
|
|
37
|
+
email = "gobslim@daum.net"
|
|
38
|
+
|
|
39
|
+
[project.urls]
|
|
40
|
+
Homepage = "https://github.com/bslim1009/capped-video-mcp"
|
|
41
|
+
Issues = "https://github.com/bslim1009/capped-video-mcp/issues"
|
|
42
|
+
|
|
43
|
+
[project.scripts]
|
|
44
|
+
capped-video-mcp = "capped_video_mcp:main"
|
|
45
|
+
|
|
46
|
+
[build-system]
|
|
47
|
+
requires = ["uv_build>=0.13.8,<0.14.0"]
|
|
48
|
+
build-backend = "uv_build"
|
|
49
|
+
|
|
50
|
+
[dependency-groups]
|
|
51
|
+
dev = [
|
|
52
|
+
"pytest>=9.2.0",
|
|
53
|
+
"pytest-asyncio>=1.5.0",
|
|
54
|
+
]
|
|
55
|
+
|
|
56
|
+
[tool.pytest.ini_options]
|
|
57
|
+
asyncio_mode = "auto"
|
|
58
|
+
asyncio_default_fixture_loop_scope = "function"
|
|
59
|
+
testpaths = ["tests"]
|
|
60
|
+
|
|
61
|
+
[tool.ruff]
|
|
62
|
+
line-length = 130
|
|
63
|
+
|
|
64
|
+
[tool.ruff.lint]
|
|
65
|
+
select = [
|
|
66
|
+
"E",
|
|
67
|
+
"F",
|
|
68
|
+
"W",
|
|
69
|
+
"B",
|
|
70
|
+
"I",
|
|
71
|
+
]
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "capped-video-mcp"
|
|
3
|
+
version = "0.1.0"
|
|
4
|
+
description = "영상 생성 모델(Seedance, Kling, Veo 등)을 fal·Replicate 로 부르는 MCP 서버. 비용 상한과 자동 다운로드 포함"
|
|
5
|
+
readme = "README.md"
|
|
6
|
+
license = "MIT"
|
|
7
|
+
license-files = ["LICENSE"]
|
|
8
|
+
keywords = ["mcp", "model-context-protocol", "capped-videoeration", "seedance", "fal", "replicate", "claude"]
|
|
9
|
+
classifiers = [
|
|
10
|
+
"Development Status :: 3 - Alpha",
|
|
11
|
+
"Intended Audience :: Developers",
|
|
12
|
+
"Operating System :: OS Independent",
|
|
13
|
+
"Programming Language :: Python :: 3 :: Only",
|
|
14
|
+
"Programming Language :: Python :: 3.12",
|
|
15
|
+
"Topic :: Multimedia :: Video",
|
|
16
|
+
]
|
|
17
|
+
authors = [
|
|
18
|
+
{ name = "임범수", email = "gobslim@daum.net" }
|
|
19
|
+
]
|
|
20
|
+
requires-python = ">=3.12"
|
|
21
|
+
dependencies = [
|
|
22
|
+
"anyio>=4.16.0",
|
|
23
|
+
"filelock>=4.2.12",
|
|
24
|
+
"httpx>=0.28.1",
|
|
25
|
+
"mcp[cli]>=2.3.0",
|
|
26
|
+
"pydantic>=2.14.4",
|
|
27
|
+
"python-dotenv>=1.2.4",
|
|
28
|
+
]
|
|
29
|
+
|
|
30
|
+
[project.urls]
|
|
31
|
+
Homepage = "https://github.com/bslim1009/capped-video-mcp"
|
|
32
|
+
Issues = "https://github.com/bslim1009/capped-video-mcp/issues"
|
|
33
|
+
|
|
34
|
+
[project.scripts]
|
|
35
|
+
capped-video-mcp = "capped_video_mcp:main"
|
|
36
|
+
|
|
37
|
+
[build-system]
|
|
38
|
+
requires = ["uv_build>=0.13.8,<0.14.0"]
|
|
39
|
+
build-backend = "uv_build"
|
|
40
|
+
|
|
41
|
+
[dependency-groups]
|
|
42
|
+
dev = [
|
|
43
|
+
"pytest>=9.2.0",
|
|
44
|
+
"pytest-asyncio>=1.5.0",
|
|
45
|
+
]
|
|
46
|
+
|
|
47
|
+
[tool.pytest.ini_options]
|
|
48
|
+
asyncio_mode = "auto"
|
|
49
|
+
asyncio_default_fixture_loop_scope = "function"
|
|
50
|
+
testpaths = ["tests"]
|
|
51
|
+
|
|
52
|
+
[tool.ruff]
|
|
53
|
+
line-length = 130
|
|
54
|
+
|
|
55
|
+
[tool.ruff.lint]
|
|
56
|
+
select = ["E", "F", "W", "B", "I"]
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
"""영상 생성 MCP 서버 (fal, Replicate)."""
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
def main() -> None:
|
|
5
|
+
import sys
|
|
6
|
+
|
|
7
|
+
# Windows 콘솔 기본 인코딩(cp949)에서 stderr 로그 한글이 깨지지 않게 한다. stdout(프로토콜)은 건드리지 않는다.
|
|
8
|
+
if hasattr(sys.stderr, "reconfigure"):
|
|
9
|
+
sys.stderr.reconfigure(encoding="utf-8", errors="replace")
|
|
10
|
+
|
|
11
|
+
from .log import setup_logging
|
|
12
|
+
from .server import create_server
|
|
13
|
+
from .service import build_app
|
|
14
|
+
|
|
15
|
+
app = build_app()
|
|
16
|
+
server = create_server(app)
|
|
17
|
+
# SDK 가 stderr 로그 핸들러를 만든 뒤에 파일 핸들러와 가리기 필터를 붙인다.
|
|
18
|
+
setup_logging(app.home, app.secrets.values())
|
|
19
|
+
server.run("stdio")
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
"""백그라운드 수거: 진행 중인 작업을 주기적으로 조회하고, 완료되면 바로 내려받는다.
|
|
2
|
+
|
|
3
|
+
Replicate 는 결과를 완료 1시간 뒤 지우므로, 에이전트가 상태를 묻지 않아도 영상을 잃지 않게 한다.
|
|
4
|
+
서버가 다시 시작되면 ledger 에서 끝나지 않은 작업을 읽어 이어서 수거한다.
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
from __future__ import annotations
|
|
8
|
+
|
|
9
|
+
import asyncio
|
|
10
|
+
import logging
|
|
11
|
+
from typing import TYPE_CHECKING
|
|
12
|
+
|
|
13
|
+
if TYPE_CHECKING:
|
|
14
|
+
from .service import App
|
|
15
|
+
|
|
16
|
+
log = logging.getLogger(__name__)
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
class Collector:
|
|
20
|
+
def __init__(self, app: App, interval_sec: float):
|
|
21
|
+
self._app = app
|
|
22
|
+
self._interval = interval_sec
|
|
23
|
+
self._wake = asyncio.Event()
|
|
24
|
+
|
|
25
|
+
def wake(self) -> None:
|
|
26
|
+
"""새 작업이 생기면 다음 주기를 기다리지 않고 바로 한 번 돈다."""
|
|
27
|
+
self._wake.set()
|
|
28
|
+
|
|
29
|
+
async def poll_once(self) -> None:
|
|
30
|
+
for job_id in self._app.ledger.collectable_jobs():
|
|
31
|
+
try:
|
|
32
|
+
await self._app.process_job(job_id)
|
|
33
|
+
except Exception:
|
|
34
|
+
log.exception("작업 수거 중 오류: %s", job_id)
|
|
35
|
+
|
|
36
|
+
async def run_forever(self) -> None:
|
|
37
|
+
while True:
|
|
38
|
+
try:
|
|
39
|
+
await self.poll_once()
|
|
40
|
+
except Exception:
|
|
41
|
+
log.exception("수거 주기 오류")
|
|
42
|
+
try:
|
|
43
|
+
await asyncio.wait_for(self._wake.wait(), timeout=self._interval)
|
|
44
|
+
except TimeoutError:
|
|
45
|
+
pass
|
|
46
|
+
self._wake.clear()
|