Smart File Manager MCP

Smart File Manager MCP

An AI-powered file management system that integrates with Claude Desktop to provide intelligent file analysis, multimedia processing, and automatic organization.

Category
Visit Server

README

Smart File Manager MCP

AI 기반 스마트 파일 관리 시스템 - MCP(Model Context Protocol) 서버와 멀티미디어 처리 통합

Docker Python FastAPI MCP Version Tests

📋 프로젝트 개요

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

# 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. 프로젝트 클론
git clone https://github.com/yourusername/smart-file-manager-mcp.git
cd smart-file-manager-mcp
  1. 환경 변수 설정
cp .env.example .env
# .env 파일을 편집하여 API 키 설정
  1. Docker 컨테이너 실행
docker-compose up -d
  1. 상태 확인
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 예제

# 기본 검색
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)

환경 변수

# 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. 검색 결과 없음

    • 증상: 검색 시 빈 결과
    • 해결: 파일 인덱싱 상태 확인
    curl http://localhost:8001/stats/multimedia

  3. Docker 컨테이너 재시작

    docker-compose restart smart-file-manager-multimedia-v4

로그 확인

# 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 파일을 참조하세요.

👥 팀

  • 개발자: Your Name
  • 문의: your.email@example.com

🙏 감사의 말

  • Anthropic Claude 팀 - MCP 프로토콜 제공
  • FastAPI 커뮤니티
  • 모든 오픈소스 기여자들

⭐ 이 프로젝트가 도움이 되었다면 Star를 눌러주세요!

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured