MCP 코드베이스 인사이트 - WIP
🚧 개발 진행 중
이 프로젝트는 현재 개발 중입니다. 기능과 문서는 지속적으로 업데이트되고 있습니다.
개요
MCP Codebase Insight는 의미 분석, 패턴 감지, 문서 관리를 통해 코드베이스를 분석하고 이해하기 위한 시스템입니다.
현재 개발 현황
완료된 기능
- ✅ 핵심 벡터 저장 시스템
- ✅ 기본 지식 기반
- ✅ SSE 통합
- ✅ 테스트 프레임워크
- ✅ TDD 및 디버깅 프레임워크(rules_template 통합)
진행 중
- 🔄 문서 관리 시스템
- 🔄 고급 패턴 감지
- 🔄 성능 최적화
- 🔄 통합 테스트
- 🔄 디버깅 유틸리티 향상
계획된
- 📋 확장된 API 문서
- 📋 사용자 정의 패턴 플러그인
- 📋 고급 캐싱 전략
- 📋 배포 가이드
- 📋 포괄적인 오류 추적 시스템
빠른 시작
- 설치지엑스피1
- 기본 사용법
from mcp_codebase_insight import CodebaseAnalyzer
analyzer = CodebaseAnalyzer()
results = analyzer.analyze_code("path/to/code")
- 테스��� 실행
# 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
- 디버깅 유틸리티
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) 원칙을 따릅니다.
- 먼저 실패한 테스트를 작성하세요(빨간색)
- 테스트를 통과하기 위해 최소한의 코드를 작성하세요(녹색)
- 테스트를 통과하는 동시에 깔끔한 코드를 위해 리팩토링(리팩토링)
TDD 문서는 docs/tdd/workflow.md 에서 확인할 수 있습니다.
디버깅 프레임워크
우리는 Agans의 디버깅 9가지 규칙을 사용합니다.
- 시스템을 이해하세요
- 실패하게 만들어라
- 생각을 멈추고 바라보세요
- 분할하고 정복하다
- 한 번에 한 가지씩 바꾸세요
- 감사 추적을 유지하세요
- 플러그를 확인하세요
- 새로운 관점을 얻으세요
- 당신이 고치지 않았다면, 그것은 고쳐지지 않습니다
docs/debuggers/agans_9_rules.md 에서 디버깅 방식에 대해 자세히 알아보세요.
선적 서류 비치
기여하다
기여를 환영합니다! 자세한 내용은 기여 가이드를 참조하세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
지원하다