GlitterKill/sdl-mcp

해결하는 문제

SDL-MCP는 AI 코드 에이전트의 '컨텍스트 예산' 문제를 해결합니다. 전체 소스 파일을 LLM에 입력하는 대신, 특정 작업에 필요한 코드와 메타데이터만 정확하게 탐색하고 검색할 수 있는 구조화된 방법을 제공합니다.

작동 방식

시스템은 코드베이스를 심볼 그래프로 인덱싱합니다. '아이리스 게이트 래더'라고 불리는 계층적 검색 방식을 사용하여, 에이전트가 작고 효율적인 메타데이터(심볼 카드)에서 시작해 스켈레톤, 핫패스, 마지막으로 제한된 소스 코드 창으로 단계적으로 확장할 수 있습니다. tree-sitter를 활용해 구조를 분석하고, SCIP 또는 언어 제공자 정보와 통합하여 정확한 크로스 참조를 구현합니다. 이 프로젝트는 Model Context Protocol (MCP)를 구현하여 stdio 또는 HTTP를 통해 AI 클라이언트와 통신합니다.

대상 사용자

대규모 리포지토리를 효율적으로 탐색해야 하지만 모델의 컨텍스트 창을 과도하게 부담시키고 싶지 않은 AI 코드 에이전트를 개발하거나 사용하는 개발자들을 위한 것입니다.

주요 특징

• 심볼 카드: 각 심볼에 대한 컴팩트한 메타데이터로, 에이전트가 전체 파일을 열지 않고도 탐색을 시작할 수 있습니다.
• 그래프 슬라이싱: 단순한 디렉터리 경계가 아닌, 리포지토리 간 관계와 작업 범위에 따라 하위 그래프를 검색합니다.
• 델타 팩: 버전 간 변경 사항을 분석하여 영향을 받는 심볼을 식별하고, PR 리뷰 시 '폭발 반경'을 계산합니다.
• 라이브 인덱싱: 파일 저장 전에 실시간으로 컨텍스트를 업데이트할 수 있는 라이브 오버레이를 통해 드래프트 버퍼 업데이트를 지원합니다.
• 개발 메모리: 리포지토리와 직접 연결된 결정 기록과 작업 메모를 선택적으로 저장할 수 있습니다.
• 도구 게이트웨이: AI 클라이언트에 노출할 도구 수를 최적화하기 위해 유연한 도구 표면(Flat, Gateway, Code 모드)을 제공합니다.