git-finder-mcp
사내 여러 Git 프로젝트에서 코드를 검색해주는 MCP 서버. Claude Code에 연결하여 자연어로 코드 검색이 가능합니다.
설치
npm install
claude mcp add git-finder -- npx tsx /path/to/git-finder-mcp/src/index.ts끝! 별도의 빌드나 ripgrep 설치가 필요 없습니다.
@vscode/ripgrep패키지가 ripgrep 바이너리를 자동으로 포함합니다.tsx가 TypeScript를 직접 실행하므로 빌드 단계가 없습니다.
사전 요구사항
- Node.js 18+
수동 설정
.claude.json에 직접 추가할 수도 있습니다:
{
"mcpServers": {
"git-finder": {
"command": "npx",
"args": ["tsx", "/path/to/git-finder-mcp/src/index.ts"]
}
}
}사용법
Claude Code에서 자연어로 사용합니다:
# 프로젝트 등록
"이 경로를 payment-service라는 이름으로 등록해줘: /Users/box/work/monorepo/packages/payment"
# 코드 검색
"결제 관련 코드 찾아줘"
"인증 미들웨어 어떤 프로젝트에서 쓰고 있어?"
"공통 유틸 함수 중에 날짜 관련된 거 보여줘"
# 프로젝트 구조 확인
"payment-service 프로젝트 구조 보여줘"데이터 저장 위치
등록한 프로젝트 목록은 홈 디렉토리에 저장됩니다:
~/.git-finder-mcp/projects.jsonMCP 버전이 바뀌거나 재설치해도 데이터가 유지됩니다.
MCP Tools
| Tool | 설명 | |------|------| | add_project | 로컬 경로의 Git 프로젝트를 등록 | | remove_project | 등록된 프로젝트 제거 | | list_projects | 등록된 프로젝트 목록 + 설명 반환 | | search_code | 키워드로 코드 검색 (ripgrep 사용) | | get_file_tree | 프로젝트 파일/폴더 구조 반환 | | read_file | 특정 파일 내용 읽기 |
검색 제외 대상
ripgrep이 .gitignore를 자동 반영하며, 추가로 다음을 제외합니다:
- 폴더: node_modules, dist, build, .git, .next, coverage, __pycache__, .turbo, .cache
- 파일: .lock, .map, .min.js, .min.css
- 바이너리: 이미지, 폰트, 오디오, 비디오 등
향후 계획 (Backlog)
현재 버전에서는 보류하고, 필요에 따라 추후 도입할 기능들:
1. 벡터 검색 도입
- 도입 조건: 프로젝트가 30개 이상으로 늘어나거나, grep 기반 검색의 정확도가 부족할 때
- 효과: "결제"로 검색하면 "payment", "checkout", "billing" 등 의미적으로 관련된 코드까지 자동 검색 (현재는 Claude가 키워드 확장으로 보완)
- 필요 기술: 임베딩 모델 (OpenAI text-embedding-3-small 등), 벡터 DB (ChromaDB 등)
- 고려사항: 코드 인덱싱 시 임베딩 API 비용 발생, 코드 청크 분할 전략 (함수/클래스 단위) 필요
2. npm 패키지 배포
- 도입 조건: 팀원들이 이 MCP를 자주 사용할 때
- 효과:
npx -y git-finder-mcp한 줄로 사용 가능. 로컬 clone / npm install 불필요 - 필요 작업:
dist/빌드 후 npm publish,bin필드 추가, tsx를 devDependency로 전환
3. Git URL로 프로젝트 추가
- 도입 조건: 로컬에 clone 없는 프로젝트도 등록하고 싶을 때
- 기능: add_project에 url 파라미터 추가. MCP 서버가 자동 clone/pull 수행
- 고려사항: private repo 인증 (SSH key / Personal Access Token), clone 저장 경로 관리, 자동 최신화 주기 설정
