Skip to main content
Glama
hyoseop1231

Smart File Manager MCP

by hyoseop1231
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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과의 완벽한 통합

Related MCP server: MCP Code Analyzer

🛠️ 기술 스택

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

👥 팀

🙏 감사의 말

  • Anthropic Claude 팀 - MCP 프로토콜 제공

  • FastAPI 커뮤니티

  • 모든 오픈소스 기여자들

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Code Analyzer

    emiryasar
    A
    license
    Not graded
    quality
    D
    maintenance
    A comprehensive code analysis and management tool that integrates with Claude Desktop to analyze code at project and file levels, helping adapt changes to projects intelligently.
    39
    MIT

  • MyAIGist MCP

    schwim23
    F
    license
    Not graded
    quality
    D
    maintenance
    A local document intelligence and knowledge management server for Claude Desktop that provides RAG-powered Q\&A, media transcription, and URL crawling. It features 11 tools for processing various file types and managing a persistent local vector store with zero infrastructure costs.
    1
    -

  • Claude MCP File Server

    ErosAO
    F
    license
    Not graded
    quality
    D
    maintenance
    A file management system powered by Claude AI that provides document access and manipulation through MCP protocol and Telegram bot integration, enabling users to interact with files via natural language commands.
    -