파일 컨텍스트 서버

대장간 배지

대규모 언어 모델(LLM)에 파일 시스템 컨텍스트를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 LLM은 고급 캐싱 및 실시간 파일 감시 기능을 통해 코드 파일을 읽고, 검색하고, 분석할 수 있습니다.

특징

파일 작업
- 파일 및 디렉토리 내용 읽기
- 자세한 메타데이터가 포함된 파일 나열
- 실시간 파일 감시 및 캐시 무효화
- 여러 파일 인코딩 지원
- 재귀적 디렉토리 탐색
- 파일 유형 필터링
코드 분석
- 순환 복잡도 계산
- 종속성 추출
- 댓글 분석
- 품질 측정 항목:
  - 중복 라인 감지
  - 긴 줄 감지(>100자)
  - 복소 함수 식별
  - 줄 수(전체, 비어 있지 않음, 주석)
스마트 캐싱
- LRU(최근 사용 횟수) 캐싱 전략
- 파일 변경 시 자동 캐시 무효화
- 구성 가능한 제한을 갖춘 크기 인식 캐싱
- 캐시 통계 및 성능 측정 항목
- 효율적인 검색을 위한 마지막 읽기 결과 캐싱
고급 검색
- 정규식 패턴 매칭
- 구성 가능한 주변 라인을 통한 상황 인식 결과
- 파일 유형 필터링
- 다중 패턴 검색 지원
- 캐시된 결과 검색
- 제외 패턴

Smithery 를 통해 Claude Desktop용 File Context Server를 자동으로 설치하려면:

지엑스피1

npm install @modelcontextprotocol/file-context-server

npx file-context-server

목록_컨텍스트_파일
- 자세한 메타데이터와 함께 디렉토리의 파일을 나열합니다.
{ "path": "./src", "recursive": true, "includeHidden": false }
읽기_컨텍스트
- 메타데이터가 포함된 파일 또는 디렉토리 내용을 읽습니다.
{ "path": "./src/index.ts", "encoding": "utf8", "maxSize": 1000000, "recursive": true, "fileTypes": ["ts", "js"] }
검색 컨텍스트
- 컨텍스트가 있는 파일에서 패턴 검색
{ "pattern": "function.*", "path": "./src", "options": { "recursive": true, "contextLines": 2, "fileTypes": ["ts"] } }
분석_코드
- 품질 측정 항목을 위해 코드 파일을 분석합니다.
{ "path": "./src", "recursive": true, "metrics": ["complexity", "dependencies", "quality"] }
캐시 통계
- 캐시 통계 및 성능 측정 항목을 가져옵니다.
{ "detailed": true }

서버는 특정 오류 코드와 함께 자세한 오류 메시지를 제공합니다.

사용자 정의를 위한 환경 변수:

# Install dependencies npm install # Build npm run build # Run tests npm test # Start in development mode npm run dev

MIT

기여를 환영합니다! 행동 강령과 풀 리퀘스트 제출 절차에 대한 자세한 내용은 기여 가이드를 참조하세요.

참고: 2025년 4월부터 File Context Server의 모든 파일 및 디렉터리 경로 처리가 개선된 크로스 플랫폼(Windows, macOS, Linux) 호환성을 위해 업데이트되었습니다.

모든 글로브 패턴은 내부적으로 POSIX 스타일 경로(슬래시)를 사용하여 OS에 관계없이 일관된 파일 일치를 보장합니다.
모든 파일 시스템 작업(읽기, 쓰기, 통계 등)은 안정성을 위해 정규화된 절대 경로를 사용합니다.
서버를 개발하거나 확장하는 경우 glob 패턴에는 path.posix.join 사용하고 파일 시스템 액세스에는 path.normalize 사용합니다.
이 변경을 통해 서로 다른 운영 체제에서 경로 구분 기호 및 파일 일치와 관련된 문제가 방지됩니다.

최종 사용자에게는 아무런 변경이 필요하지 않지만, 개발자는 프로젝트에 참여할 때 이러한 규칙을 따라야 합니다.