Codebase MCP

코드베이스 MCP

RepoMix를 사용하여 전체 코드베이스를 검색하고 분석하는 도구를 제공하는 MCP(Model Context Protocol) 서버 구현입니다.

이 MCP를 사용하면 Cursor의 Composer Agent와 같은 AI 에이전트가 전체 코드베이스를 한 번에 자동으로 읽고 이해할 수 있으므로 개발자는 대규모 코드베이스로 작업하기가 더 쉬워지고 AI 어시스턴트는 프로젝트에 대한 포괄적인 맥락을 파악하기가 더 쉬워집니다.

특징

• 📚 코드베이스 검색 : 전체 코드베이스를 다양한 형식(XML, 마크다운, 일반)의 단일 텍스트 출력으로 검색합니다.
• 🌐 원격 저장소 지원 : 원격 GitHub 저장소를 직접 처리합니다.
• 💾 파일 저장 : 처리된 코드베이스를 파일에 저장합니다.
• 🔧 사용자 정의 옵션 : 다양한 옵션(주석, 줄 번호, 파일 요약 등)을 사용하여 코드베이스가 처리되는 방식을 제어합니다.

설치

NPM에서 (추천)

지엑스피1

GitHub에서

커서와의 통합

이 MCP를 Cursor의 Composer Agent와 함께 사용하려면:

1. 커서 IDE 열기
2. 사이드바에서 Composer 아이콘을 클릭하세요
3. 상단의 "MCP 서버" 버튼을 클릭하세요
4. "새 MCP 서버 추가"를 클릭하세요.
5. 자세한 내용을 입력하세요:
   • 이름: Codebase MCP (또는 원하는 이름)
   • 유형: command
   • 명령어: codebase-mcp start
6. "추가"를 클릭하여 저장하세요

MCP를 추가하면 Composer Agent에 세 가지 강력한 도구가 제공됩니다.

사용 가능한 도구

1. getCodebase
   • 목적: 현재 작업 공간/프로젝트 분석
   • 사용 시기: AI가 전체 코드베이스를 이해하도록 하려는 경우
   • 예시 프롬프트: "코드베이스의 구조를 이해하려면 코드베이스를 분석하세요"
2. getRemoteCodebase
   • 목적: 모든 공개 GitHub 저장소를 가져와 분석합니다.
   • 사용 시기: 다른 프로젝트를 탐색하거나 이해하고 싶을 때
   • 예시 프롬프트: "github.com/username/repo의 저장소를 분석할 수 있나요?"
3. 코드베이스 저장
   • 목적: 나중에 사용할 수 있도록 코드베이스 분석을 파일에 저장합니다.
   • 사용 시기: 코드베이스 스냅샷을 보존하거나 공유하려는 경우
   • 예시 프롬프트: "나중에 검토하기 위해 이 코드베이스에 대한 분석을 저장하세요"

커서에서의 사용 예

다음은 Composer Agent와 함께 사용할 수 있는 몇 가지 프롬프트 예시입니다.

Composer Agent는 귀하의 요청에 따라 자동으로 적절한 도구를 사용합니다.

커서 외부 사용

MCP 서버 시작

이렇게 하면 MCP 서버가 stdio 모드로 시작되며, 모든 MCP 호환 클라이언트에서 사용할 수 있습니다.

특허

MIT