FileScopeMCP

당신의 AI는 이미 코딩 방법을 알고 있습니다. 이제 당신의 코드베이스도 알게 됩니다.

FileScopeMCP는 코드를 감시하고, 모든 파일의 중요도를 순위 매기며, 모든 의존성을 매핑하고, AI가 생성한 요약을 백그라운드에서 최신 상태로 유지합니다. LLM이 "이 파일은 무슨 역할을 하나요?"라고 물을 때, 소스 코드를 읽지 않고도 정확한 답변을 얻을 수 있습니다.

Claude Code, Cursor AI와 함께 작동하거나 독립형 데몬으로 사용할 수 있습니다. 12개 언어를 기본적으로 지원합니다.

주요 기능

중요도 순위 — 파일이 얼마나 많은 곳에서 참조되는지, 무엇을 내보내는지, 어디에 위치하는지에 따라 모든 파일에 0-10점의 점수가 매겨집니다. LLM은 가장 중요한 파일을 먼저 확인합니다.

의존성 매핑 — Python, JS/TS, C/C++, Rust, Go, Ruby, Lua, Zig, PHP, C#, Java 전반에 걸친 양방향 import 추적. 순환 의존성도 찾아냅니다.

항상 최신 상태 — 파일 감시자 + 의미론적 변경 감지를 통해 메타데이터가 자동으로 업데이트됩니다. TS/JS는 AST 수준의 diff를, 그 외 언어는 LLM 기반 분석을 사용합니다. 실제로 변경된 부분만 다시 처리합니다.

LLM 브로커 — 백그라운드 프로세스가 llama.cpp의 llama-server(또는 OpenAI 호환 HTTP API)를 통해 모든 AI 작업을 조정합니다. 우선순위 큐를 통해 대화형 쿼리가 백그라운드 처리보다 우선시됩니다. 단일 GPU에서 실행됩니다.

Nexus 대시보드 — localhost:1234에서 제공되는 웹 UI로, 모든 저장소의 코드베이스를 시각적으로 탐색할 수 있습니다. 대화형 의존성 그래프, 파일 상세 패널, 실시간 브로커 활동, 저장소별 상태 모니터링을 제공합니다.

Related MCP server: GonMCPtool

빠른 시작

git clone https://github.com/admica/FileScopeMCP.git
cd FileScopeMCP
./build.sh          # installs deps, compiles, registers with Claude Code

이것으로 끝입니다. 프로젝트에서 Claude Code 세션을 열면 FileScopeMCP가 자동으로 초기화됩니다. 다음을 시도해 보세요:

find_important_files(limit: 5)
status()

AI 요약을 원하시나요? ./setup-llm.sh를 실행하여 플랫폼별 llama.cpp llama-server 설정 가이드를 확인하세요. 자세한 내용은 docs/llm-setup.md를 참조하세요. 설정하지 않아도 다른 기능은 모두 정상 작동합니다.

프로젝트의 .gitignore에 다음을 추가하세요:

.filescope/
.filescope-daemon.log

MCP 도구

Nexus 대시보드

npm run nexus       # opens at http://localhost:1234

머신에 있는 모든 FileScopeMCP 저장소에 연결되는 읽기 전용 웹 대시보드입니다:

• 프로젝트 뷰 — 중요도 히트맵 색상과 최신성 표시기가 포함된 파일 트리, 파일을 클릭하여 전체 메타데이터 확인

• 의존성 그래프 — 대화형 Cytoscape.js 시각화, 디렉토리별 필터링, 노드 클릭을 통한 검사

• 시스템 뷰 — 실시간 브로커 상태, 저장소별 토큰 사용량, 스트리밍 활동 로그

• 설정 — 표시할 저장소 관리, 블랙리스트에서 제거 또는 복원

.filescope/data.db 디렉토리를 스캔하여 저장소를 자동으로 발견합니다. 별도의 설정이 필요 없습니다.

작동 원리

Your code changes
    → file watcher picks it up
    → AST diff classifies the change (exports? types? body only?)
    → importance scores recalculated
    → staleness cascades to dependents (only if exports/types changed)
    → LLM broker regenerates summaries, concepts, change impact
    → your AI's next query gets fresh answers

모든 데이터는 프로젝트별 .filescope/data.db(SQLite, WAL 모드)에 저장됩니다. 브로커는 ~/.filescope/broker.sock의 Unix 소켓을 통해 모든 저장소의 LLM 작업을 조정합니다.

문서

라이선스

Copyright (c) 2026 admica. All rights reserved. LICENSE를 참조하세요.