Smart File Manager MCP
by hyoseop1231
README.md
# Smart File Manager MCP
> AI 기반 스마트 파일 관리 시스템 - MCP(Model Context Protocol) 서버와 멀티미디어 처리 통합
[](https://www.docker.com/)
[](https://www.python.org/)
[](https://fastapi.tiangolo.com/)
[](https://github.com/modelcontextprotocol)
[](https://github.com/modelcontextprotocol)
[](https://github.com/modelcontextprotocol)
## 📋 프로젝트 개요
Smart File Manager MCP는 Claude Desktop과 통합되는 고급 파일 관리 시스템입니다. AI 기반 파일 분석, 멀티미디어 처리, 자동 정리 기능을 제공합니다.
### 🌟 주요 기능
- **🤖 AI 기반 파일 분석**: 이미지 인식, 음성 인식, 텍스트 추출
- **📁 스마트 파일 정리**: AI가 파일 내용을 분석하여 자동 분류
- **🔍 고급 검색**: FTS5 기반 전문 검색 및 의미 기반 검색
- **🎬 멀티미디어 처리**: 이미지, 비디오, 오디오 파일 분석 및 썸네일 생성
- **📊 실시간 모니터링**: Prometheus + Grafana 통합
- **🔌 MCP 프로토콜**: Claude Desktop과의 완벽한 통합
## 🛠️ 기술 스택
- **Backend**: Python 3.11+, FastAPI, SQLite (FTS5)
- **AI/ML**: OpenRouter API (Gemini, GPT-4o, Qwen), Faster-Whisper, bge-m3
- **설정 관리**: pydantic-settings, python-dotenv
- **캐싱**: Redis (redis.asyncio), Memory Cache (Fallback)
- **검색**: SQLite FTS5, Qdrant (벡터 DB)
- **모니터링**: Prometheus, Grafana
- **컨테이너**: Docker, Docker Compose
- **MCP**: Model Context Protocol Server
## 📦 시스템 구조
### v5.0 아키텍처 (리팩토링 후)
```
smart-file-manager-mcp/
├── src/smart_file_manager/ # v5.0+ 리팩토링 모듈
│ ├── core/ # 핵심 설정 및 예외
│ │ ├── config.py # Settings (pydantic-settings)
│ │ ├── exceptions.py # 커스텀 예외 클래스
│ │ └── constants.py # 상수 정의
│ ├── infrastructure/ # 인프라 계층
│ │ └── cache/ # 캐시 시스템
│ │ ├── base.py # CacheInterface (추상 클래스)
│ │ ├── memory_cache.py # MemoryCache
│ │ └── redis_cache.py # RedisCache
│ ├── services/ # 서비스 계층
│ │ ├── openrouter_client.py # OpenRouter API 클라이언트
│ │ ├── model_config.py # 모델 티어 및 Fallback 설정
│ │ ├── vision_service.py # 통합 Vision 분석 서비스
│ │ ├── stt_models.py # STT 데이터 모델 (NEW: SPEC-STT-001)
│ │ └── stt_service.py # STT 서비스 (Faster-Whisper)
│ ├── processors/ # 프로세서 계층 (SPEC-VISION-001)
│ │ ├── base_processor.py # 추상 기반 클래스
│ │ ├── image_processor.py # 이미지 분석 프로세서
│ │ └── video_processor.py # 비디오 분석 프로세서
│ ├── classification/ # 분류 서비스 (SPEC-CLASS-001)
│ │ ├── models.py # 분류 데이터 모델
│ │ ├── category_registry.py # 카테고리 레지스트리
│ │ ├── tag_generator.py # 태그 생성기 (한/영)
│ │ ├── engine.py # 하이브리드 분류 엔진
│ │ ├── organization_planner.py # 파일 정리 플래너
│ │ └── classification_service.py # 통합 분류 서비스
│ └── organization/ # 파일 정리 서비스 (NEW: SPEC-ORG-001)
│ ├── organization_service.py # 통합 정리 실행 서비스
│ ├── organization_executor.py # 파일 작업 실행 엔진
│ ├── safety_validator.py # 안전성 검증
│ ├── conflict_resolver.py # 충돌 해결
│ ├── transaction_manager.py # 트랜잭션 관리
│ ├── progress_tracker.py # 진행 추적
│ └── models.py # 데이터 모델
├── ai-services/ # Legacy AI 서비스 모듈
│ ├── multimedia_api_v4.py # 멀티미디어 API 서버
│ ├── enhanced_indexer_v4.py # 파일 인덱싱 엔진
│ ├── multimedia_processor.py # 멀티미디어 처리
│ ├── ai_vision_service.py # AI 비전 서비스
│ ├── speech_recognition_service.py # 음성 인식
│ └── db_connection_pool.py # DB 연결 풀
├── monitoring/ # 모니터링 설정
│ ├── prometheus.yml
│ └── grafana/
└── docker-compose.yml # Docker 설정
```
### API 클라이언트 아키텍처 다이어그램
```
┌─────────────────────────────────────────────────┐
│ OpenRouter API Client │
│ (SPEC-API-001) │
└─────────────────────────────────────────────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Primary │ │ Fallback 1 │ │ Fallback 2 │
│ (Balanced) │───▶│ (Low-cost) │───▶│ (Free) │
│ Gemini Flash │ │ Qwen 2.5 VL │ │ Gemini Free │
│ $0.10/1M in │ │ $0.05/1M in │ │ $0 │
└──────────────┘ └──────────────┘ └──────────────┘
│ │ │
└────────────────────┼────────────────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Cache │ │ Retry │ │ Budget │
│ (7d TTL) │ │ (Exp B/O) │ │ Monitoring │
│ Redis/Memory │ │ 1s→2s→4s+J │ │ $1/d, $30/m │
└──────────────┘ └──────────────┘ └──────────────┘
```
## 🆕 v5.0.0 리팩토링
### Phase 1: 인프라 설정 (SPEC-INFRA-001) - 완료
**인프라 아키텍처**:
```
src/smart_file_manager/
├── core/
│ ├── config.py # Settings 클래스 (pydantic-settings)
│ └── exceptions.py # 커스텀 예외 클래스
└── infrastructure/
└── cache/
├── base.py # CacheInterface (추상 클래스)
├── memory_cache.py # MemoryCache (인메모리 캐시)
└── redis_cache.py # RedisCache (Redis 기반 캐시)
```
**주요 변경사항**:
- **OpenRouter API 통합**: OpenAI 대신 OpenRouter API 사용 (비용 90% 절감)
- **pydantic-settings**: 환경 변수 검증 및 타입 안전성
- **이중 캐시 시스템**: Redis (기본) + Memory (Fallback)
- **테스트 커버리지**: 99%+ (77개 테스트 통과)
### Phase 2: OpenRouter API 클라이언트 (SPEC-API-001) - 완료
**API 클라이언트 아키텍처**:
```
src/smart_file_manager/
└── services/
├── openrouter_client.py # 핵심 API 클라이언트
└── model_config.py # 모델 티어 및 Fallback 설정
```
**핵심 기능**:
- **httpx 비동기 클라이언트**: Bearer 토큰 인증 기반 HTTPS 통신
- **3단계 Fallback 체인**: Balanced -> Low-cost -> Free 모델 자동 전환
- Primary: `google/gemini-2.0-flash-001` (Balanced)
- Fallback 1: `qwen/qwen2.5-vl-32b-instruct` (Low-cost)
- Fallback 2: `google/gemini-2.0-flash-exp:free` (Free)
- **지수 백오프 재시도**: 1s -> 2s -> 4s + 랜덤 Jitter (0-500ms)
- **비용 모니터링**: 일일 $1 / 월간 $30 예산 제한 및 추적
- **캐시 통합**: 성공 응답 7일 TTL 캐싱 (Redis/Memory)
### Phase 3: Vision 분석 서비스 (SPEC-VISION-001) - 완료
**Vision 서비스 아키텍처**:
```
src/smart_file_manager/
├── services/
│ └── vision_service.py # 통합 Vision 분석 서비스
└── processors/
├── base_processor.py # 추상 기반 클래스
├── image_processor.py # 이미지 분석 (OpenRouter API)
└── video_processor.py # 비디오 분석 (FFmpeg + 키프레임)
```
**Vision 서비스 Fallback 체인**:
```
┌─────────────────────────────────────────────────┐
│ Vision Analysis Service │
│ (SPEC-VISION-001) │
└─────────────────────────────────────────────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Primary │ │ Fallback 1 │ │ Fallback 2 │
│ Vision │───▶│ Vision │───▶│ Vision │
│ Gemini Flash │ │ Qwen 2.5 VL │ │ Gemini Free │
└──────────────┘ └──────────────┘ └──────────────┘
│ │ │
└────────────────────┼────────────────────┘
│
▼
┌──────────────────┐
│ Local Fallback │
│ (메타데이터 분석) │
└──────────────────┘
```
**핵심 기능**:
- **VisionService**: 이미지/비디오 통합 분석 서비스
- **ImageProcessor**: scene description, object detection, OCR 텍스트 추출
- **VideoProcessor**: FFmpeg 키프레임 추출, 대표 프레임 분석 (최대 5개)
- **4단계 Fallback**: Primary -> Low-cost -> Free -> Local 메타데이터
- **캐시 통합**: 콘텐츠 해시 기반 7일 TTL 캐싱
- **비용 최적화**: 일일 $1 예산 초과 시 Free 티어 자동 전환
- **테스트 커버리지**: 90.59% (327 테스트 통과)
### Phase 4: 파일 분류 서비스 (SPEC-CLASS-001) - 완료
**Classification 서비스 아키텍처**:
```
src/smart_file_manager/
└── classification/
├── models.py # 분류 데이터 모델
├── category_registry.py # 카테고리 레지스트리
├── tag_generator.py # 태그 생성기 (한/영)
├── engine.py # 하이브리드 분류 엔진
├── organization_planner.py # 파일 정리 플래너
└── classification_service.py # 통합 분류 서비스
```
**Classification 서비스 다이어그램**:
```
┌─────────────────────────────────────────────────┐
│ Classification Service │
│ (SPEC-CLASS-001) │
└─────────────────────────────────────────────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ User Rules │ │ AI Analysis │ │ Metadata │
│ (Priority) │───▶│ (VisionSvc) │───▶│ Rules │
│ 사용자 규칙 │ │ AI 분석 연동 │ │ 메타데이터 │
└──────────────┘ └──────────────┘ └──────────────┘
│ │ │
└────────────────────┼────────────────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Category │ │ Tag │ │ Organization │
│ Registry │ │ Generator │ │ Planner │
│ 8개 기본 분류 │ │ 한/영 이중화 │ │ 날짜 기반정리│
└──────────────┘ └──────────────┘ └──────────────┘
```
**핵심 기능**:
- **ClassificationService**: 통합 분류 서비스 (VisionService 연동)
- **ClassificationEngine**: 하이브리드 분류 (사용자규칙 > AI > 메타데이터)
- **CategoryRegistry**: 8개 기본 카테고리 + 커스텀 카테고리
- `photo`, `screenshot`, `document`, `artwork`, `meme`, `product`, `video`, `other`
- **TagGenerator**: 한/영 이중 언어 태그 생성 (150+ 번역)
- **OrganizationPlanner**: 날짜 기반 파일 정리 추천
- **BatchClassifier**: 비동기 배치 분류 (동시성 제한: 10)
- **테스트 커버리지**: 89.41% (451 테스트 통과)
### Phase 5: STT 서비스 (SPEC-STT-001) - 완료
**STT 서비스 아키텍처**:
```
src/smart_file_manager/
└── services/
├── stt_models.py # STT 데이터 모델
└── stt_service.py # STT 서비스 (Faster-Whisper)
```
**STT 서비스 다이어그램**:
```
┌─────────────────────────────────────────────────┐
│ STT Service │
│ (SPEC-STT-001) │
└─────────────────────────────────────────────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Lazy Model │ │ Device │ │ Cache │
│ Loading │ │ Detection │ │ Integration │
│ 지연 초기화 │ │ CUDA/CPU 감지│ │ Redis/Memory │
└──────────────┘ └──────────────┘ └──────────────┘
│ │ │
└────────────────────┼────────────────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Whisper │ │ Batch │ │ Stats & │
│ Models │ │ Processing │ │ Monitoring │
│ large-v3 기본│ │ 동시성 제어 │ │ 실시간 통계 │
└──────────────┘ └──────────────┘ └──────────────┘
```
**핵심 기능**:
- **STTService**: Faster-Whisper 기반 음성-텍스트 변환 서비스
- **지연 로딩**: 첫 요청 시 Whisper 모델 로딩 (메모리 최적화)
- **디바이스 자동 감지**: CUDA/CPU 자동 선택 및 compute_type 최적화
- CUDA: `float16` (GPU 최적)
- CPU: `int8` (메모리 효율)
- **지원 포맷**: MP3, WAV, FLAC, OGG, M4A, WMA, WEBM
- **타임스탬프**: 단어/세그먼트 단위 타임스탬프 생성
- **배치 처리**: 비동기 배치 분석 (동시성 제한: 3)
- **캐시 통합**: 콘텐츠 해시 기반 7일 TTL 캐싱
- **통계 추적**: 분석 횟수, RTF, 캐시 히트율
- **테스트 커버리지**: 90%+ (69 테스트 통과)
**데이터 모델**:
- **AudioMetadata**: 오디오 메타데이터 (duration, sample_rate, channels, codec)
- **WordTimestamp**: 단어별 타임스탬프 (word, start, end, probability)
- **TranscriptionSegment**: 세그먼트별 전사 결과 (text, confidence, words)
- **TranscriptionResult**: 전체 전사 결과 (transcription, segments, language)
- **STTStats**: 서비스 통계 (analyses, cache_hits, total_audio_seconds)
### Phase 6: 파일 정리 서비스 (SPEC-ORG-001) - 완료
**Organization 서비스 아키텍처**:
```
src/smart_file_manager/
└── organization/
├── organization_service.py # 통합 정리 실행 서비스
├── organization_executor.py # 파일 작업 실행 엔진
├── safety_validator.py # 안전성 검증
├── conflict_resolver.py # 충돌 해결
├── transaction_manager.py # 트랜잭션 관리
├── progress_tracker.py # 진행 추적
└── models.py # 데이터 모델
```
**Organization 서비스 다이어그램**:
```
┌─────────────────────────────────────────────────┐
│ Organization Service │
│ (SPEC-ORG-001) │
└─────────────────────────────────────────────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Safety │ │ Conflict │ │ Transaction │
│ Validator │ │ Resolver │ │ Manager │
│ 보호경로 검증 │ │ 충돌 해결 │ │ 롤백 지원 │
└──────────────┘ └──────────────┘ └──────────────┘
│ │ │
└────────────────────┼────────────────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Organization │ │ Progress │ │ Trash │
│ Executor │ │ Tracker │ │ Management │
│ 파일 작업 실행│ │ ETA 계산 │ │ 안전 삭제 │
└──────────────┘ └──────────────┘ └──────────────┘
```
**핵심 기능**:
- **OrganizationService**: 통합 정리 실행 서비스 (ClassificationService 연동)
- **OrganizationExecutor**: 파일 move/copy/rename/delete/group 실행
- **SafetyValidator**: 보호 경로 차단, 디스크 공간 검증, 파일 잠금 확인
- **ConflictResolver**: 4가지 충돌 해결 전략
- `skip`: 충돌 시 건너뛰기 (기본값)
- `overwrite`: 기존 파일 덮어쓰기
- `rename_suffix`: 파일명에 접미사 추가 (_1, _2)
- `ask_user`: 사용자에게 선택 요청
- **TransactionManager**: 롤백 지원 트랜잭션 관리, 크래시 복구
- **ProgressTracker**: 실시간 진행률, ETA 계산, 콜백 지원
- **휴지통 관리**: 안전 삭제 (30일 보관), 메타데이터 저장
- **배치 처리**: 비동기 배치 실행 (동시성 제한: 5)
- **dry-run 모드**: 실행 전 검증 (실제 파일 작업 없음)
- **테스트 커버리지**: 95%+ (211 테스트 추가, 총 731 테스트 통과)
**데이터 모델**:
- **OrganizationPlan**: 정리 계획 (action, source, target, conflict_strategy)
- **ExecutionResult**: 실행 결과 (success, transaction_id, error_message)
- **ValidationResult**: dry-run 검증 결과 (valid, conflicts, errors)
- **Progress**: 진행 상황 (percentage, current_file, eta_seconds)
- **RollbackResult**: 롤백 결과 (success, restored_files, failed_restorations)
### v5.0 환경 변수
#### 필수 환경 변수
| 변수명 | 필수 | 기본값 | 설명 |
|--------|------|--------|------|
| `OPENROUTER_API_KEY` | Yes | - | OpenRouter API 키 |
#### 인프라 설정 (SPEC-INFRA-001)
| 변수명 | 필수 | 기본값 | 설명 |
|--------|------|--------|------|
| `REDIS_URL` | No | `redis://localhost:6379/0` | Redis 연결 URL |
| `APP_ENV` | No | `development` | 실행 환경 |
| `CACHE_TTL_SECONDS` | No | `86400` | 캐시 TTL (초) |
| `LOG_LEVEL` | No | `INFO` | 로그 레벨 |
#### API 클라이언트 설정 (SPEC-API-001)
| 변수명 | 필수 | 기본값 | 설명 |
|--------|------|--------|------|
| `VISION_PRIMARY_MODEL` | No | `google/gemini-2.0-flash-001` | Primary Vision 모델 (Balanced) |
| `VISION_FALLBACK_MODEL` | No | `qwen/qwen2.5-vl-32b-instruct` | Fallback 1 Vision 모델 (Low-cost) |
| `VISION_FREE_MODEL` | No | `google/gemini-2.0-flash-exp:free` | Fallback 2 Vision 모델 (Free) |
| `API_DAILY_BUDGET` | No | `1.00` | 일일 API 예산 (USD) |
| `API_MONTHLY_BUDGET` | No | `30.00` | 월간 API 예산 (USD) |
| `API_CONNECT_TIMEOUT` | No | `5` | API 연결 타임아웃 (초) |
| `API_READ_TIMEOUT` | No | `30` | API 읽기 타임아웃 (초) |
| `API_MAX_RETRIES` | No | `3` | 최대 재시도 횟수 |
#### STT 서비스 설정 (SPEC-STT-001)
| 변수명 | 필수 | 기본값 | 설명 |
|--------|------|--------|------|
| `STT_MODEL_SIZE` | No | `large-v3` | Whisper 모델 크기 (tiny/base/small/medium/large-v3) |
| `STT_DEVICE` | No | `auto` | 추론 디바이스 (auto/cuda/cpu) |
| `STT_COMPUTE_TYPE` | No | `auto` | 연산 타입 (auto/float16/int8) |
| `STT_DEFAULT_LANGUAGE` | No | `None` | 기본 언어 (None=자동 감지) |
| `STT_CHUNK_LENGTH_SECONDS` | No | `30` | 청크 길이 (초) |
| `STT_ENABLE_VAD` | No | `true` | VAD(음성 활동 감지) 활성화 |
### v5.0 Quick Start
```bash
# 1. 환경 변수 설정
export OPENROUTER_API_KEY="sk-or-v1-your-key-here"
# 2. 선택적: Redis 실행 (없으면 Memory Cache 사용)
docker run -d -p 6379:6379 redis:alpine
# 3. 패키지 설치
pip install -e ".[dev]"
# 4. 테스트 실행
pytest --cov=src/smart_file_manager
```
---
## 📋 v4.0.2 업데이트 (Legacy)
### 개선사항
- **Qdrant 헬스체크 수정**: 올바른 엔드포인트로 변경
- **디스크 관리 도구 추가**:
- 디스크 사용률 모니터링 API
- 자동 정리 스크립트
- 썸네일 및 임시 파일 정리 기능
- **디스크 사용률 권장사항**: 자동 정리 제안 시스템
### 새로운 API 엔드포인트
- `GET /disk/usage` - 현재 디스크 사용률 조회
- `POST /disk/cleanup/thumbnails` - 오래된 썸네일 정리
- `POST /disk/cleanup/temp` - 임시 파일 정리
- `GET /disk/recommendations` - 디스크 정리 권장사항
## 🚀 빠른 시작
### 사전 요구사항
- Docker 및 Docker Compose
- OpenAI API 키 (AI 기능 사용 시)
- 최소 4GB RAM, 10GB 디스크 공간
### 설치 및 실행
1. **프로젝트 클론**
```bash
git clone https://github.com/yourusername/smart-file-manager-mcp.git
cd smart-file-manager-mcp
```
2. **환경 변수 설정**
```bash
cp .env.example .env
# .env 파일을 편집하여 API 키 설정
```
3. **Docker 컨테이너 실행**
```bash
docker-compose up -d
```
4. **상태 확인**
```bash
docker-compose ps
curl http://localhost:8001/health
```
## 📡 API 엔드포인트
### 핵심 엔드포인트
| 엔드포인트 | 메서드 | 설명 |
|----------|--------|------|
| `/health` | GET | 시스템 상태 확인 |
| `/search/multimedia` | POST | 멀티미디어 파일 검색 |
| `/ai/analyze` | POST | AI 파일 분석 |
| `/stats/multimedia` | GET | 멀티미디어 통계 |
| `/media/thumbnail/{id}` | GET | 썸네일 가져오기 |
### 검색 API 예제
```bash
# 기본 검색
curl -X POST http://localhost:8001/search/multimedia \
-H "Content-Type: application/json" \
-d '{"query": "회의록", "limit": 10}'
# 미디어 타입 필터링
curl -X POST http://localhost:8001/search/multimedia \
-H "Content-Type: application/json" \
-d '{"media_types": ["image", "video"], "limit": 5}'
```
## 🔧 설정
### Docker Compose 서비스
- **smart-file-manager-multimedia-v4**: 메인 API 서버 (포트 8001)
- **smart-file-redis-v4**: Redis 캐시 (포트 16379)
- **smart-file-prometheus-v4**: 메트릭 수집 (포트 9090)
- **smart-file-grafana-v4**: 모니터링 대시보드 (포트 3003)
### 환경 변수
```env
# OpenAI API 설정
OPENAI_API_KEY=your-api-key
# 파일 경로 설정
WATCH_DIRECTORIES=/watch_directories
DB_PATH=/data/db/file-index.db
EMBEDDINGS_PATH=/data/embeddings
METADATA_PATH=/data/metadata
# 서비스 포트
MULTIMEDIA_API_PORT=8001
REDIS_PORT=16379
```
## 📊 모니터링
### Grafana 대시보드
- URL: http://localhost:3003
- 기본 계정: admin/admin
- 사전 구성된 대시보드로 시스템 메트릭 확인
### Prometheus 메트릭
- URL: http://localhost:9090
- 주요 메트릭:
- 파일 인덱싱 상태
- API 응답 시간
- AI 처리 통계
- 시스템 리소스 사용량
## 🐛 트러블슈팅
### 일반적인 문제 해결
1. **API 타입 오류**
- 증상: `'>' not supported between instances of 'str' and 'int'`
- 해결: 최신 버전으로 업데이트 (v4.0에서 수정됨)
2. **검색 결과 없음**
- 증상: 검색 시 빈 결과
- 해결: 파일 인덱싱 상태 확인
```bash
curl http://localhost:8001/stats/multimedia
```
3. **Docker 컨테이너 재시작**
```bash
docker-compose restart smart-file-manager-multimedia-v4
```
### 로그 확인
```bash
# API 서버 로그
docker logs -f smart-file-manager-multimedia-v4
# 전체 서비스 로그
docker-compose logs -f
```
## 🤝 기여하기
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## 📄 라이선스
이 프로젝트는 MIT 라이선스로 배포됩니다. 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.
## 👥 팀
- **개발자**: [Your Name](https://github.com/yourusername)
- **문의**: your.email@example.com
## 🙏 감사의 말
- Anthropic Claude 팀 - MCP 프로토콜 제공
- FastAPI 커뮤니티
- 모든 오픈소스 기여자들
---
**⭐ 이 프로젝트가 도움이 되었다면 Star를 눌러주세요!**This server cannot be deployed
Maintenance
ActivityInactive
ResponsivenessNo issues