MCP 코드베이스 인사이트 - WIP

🚧 개발 진행 중

이 프로젝트는 현재 개발 중입니다. 기능과 문서는 지속적으로 업데이트되고 있습니다.

개요

MCP Codebase Insight는 의미 분석, 패턴 감지, 문서 관리를 통해 코드베이스를 분석하고 이해하기 위한 시스템입니다.

현재 개발 현황

완료된 기능

• ✅ 핵심 벡터 저장 시스템

• ✅ 기본 지식 기반

• ✅ SSE 통합

• ✅ 테스트 프레임워크

• ✅ TDD 및 디버깅 프레임워크(rules_template 통합)

진행 중

• 🔄 문서 관리 시스템

• 🔄 고급 패턴 감지

• 🔄 성능 최적화

• 🔄 통합 테스트

• 🔄 디버깅 유틸리티 향상

계획된

• 📋 확장된 API 문서

• 📋 사용자 정의 패턴 플러그인

• 📋 고급 캐싱 전략

• 📋 배포 가이드

• 📋 포괄적인 오류 추적 시스템

빠른 시작

1. 설치

   지엑스피1

2. 기본 사용법

   from mcp_codebase_insight import CodebaseAnalyzer analyzer = CodebaseAnalyzer() results = analyzer.analyze_code("path/to/code")

3. 테스트 실행

   # Run all tests pytest tests/ # Run unit tests pytest tests/unit/ # Run component tests pytest tests/components/ # Run tests with coverage pytest tests/ --cov=src --cov-report=term-missing

4. 디버깅 유틸리티

   from mcp_codebase_insight.utils.debug_utils import debug_trace, DebugContext, get_error_tracker # Use debug trace decorator @debug_trace def my_function(): # Implementation # Use debug context with DebugContext("operation_name"): # Code to debug # Track errors try: # Risky operation except Exception as e: error_id = get_error_tracker().record_error(e, context={"operation": "description"}) print(f"Error recorded with ID: {error_id}")

테스트 및 디버깅

테스트 주도 개발

이 프로젝트는 테스트 주도 개발(TDD) 원칙을 따릅니다.

1. 먼저 실패한 테스트를 작성하세요(빨간색)

2. 테스트를 통과하기 위해 최소한의 코드를 작성하세요(녹색)

3. 테스트를 통과하는 동시에 깔끔한 코드를 위해 리팩토링(리팩토링)

TDD 문서는 docs/tdd/workflow.md 에서 확인할 수 있습니다.

디버깅 프레임워크

우리는 Agans의 디버깅 9가지 규칙을 사용합니다.

1. 시스템을 이해하세요

2. 실패하게 만들어라

3. 생각을 멈추고 바라보세요

4. 분할하고 정복하다

5. 한 번에 한 가지씩 바꾸세요

6. 감사 추적을 유지하세요

7. 플러그를 확인하세요

8. 새로운 관점을 얻으세요

9. 당신이 고치지 않았다면, 그것은 고쳐지지 않습니다

docs/debuggers/agans_9_rules.md 에서 디버깅 방식에 대해 자세히 알아보세요.

선적 서류 비치

• 시스템 아키텍처

• 핵심 구성 요소

• API 참조

• 개발 가이드

• 워크플로

• TDD 워크플로

• 디버깅 관행

기여하다

기여를 환영합니다! 자세한 내용은 기여 가이드를 참조하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

지원하다

• 이슈 트래커

• 토론