ClaudeHopper

🏗️ ClaudeHopper - AI 기반 건설 문서 도우미

ClaudeHopper는 Claude와 다른 LLM들이 고급 RAG(Retrieval-Augmented Generation) 및 하이브리드 검색을 통해 시공 문서, 도면 및 시방서와 직접 상호 작용할 수 있도록 지원하는 특수 모델 컨텍스트 프로토콜(MCP) 서버입니다. 시공 도면에 대한 질문을 하고, 특정 세부 정보를 찾고, 기술 시방서를 손쉽게 분석할 수 있습니다.

✨ 특징

• 🔍 CAD 도면, 계획 및 사양에 최적화된 건설 문서 검색을 위한 벡터 기반 검색
• 🖼️ 텍스트 설명을 기반으로 유사한 그림을 찾기 위한 시각적 검색
• 🏢 건설 산업 문서 형식을 위한 특수 메타데이터 추출
• 📊 지능형 문서 청킹 및 분류를 통한 효율적인 토큰 사용
• 🔒 로컬 문서 저장 및 처리를 통한 보안
• 📈 다양한 도면 유형 및 시공 분야(구조, 토목, 건축 등) 지원

🚀 빠른 시작

필수 조건

• 노드.js 18+
• 로컬 AI 모델을 위한 Ollama
  • 필수 모델: nomic-embed-text , phi4 , clip
• 클로드 데스크톱 앱
• 이미지 추출을 위해: Poppler Utils ( pdfimages 명령어)

원클릭 설정

1. ClaudeHopper 다운로드
2. 설치 스크립트를 실행합니다.

지엑스피1

이렇게 하면:

• 필요한 디렉토리 구조를 만듭니다
• 필요한 AI 모델 설치
• 건설 문서를 처리하세요
• ClaudeHopper를 사용하도록 Claude Desktop App 구성

문서 추가

건설 문서를 다음 폴더에 보관하세요.

• 도면: ~/Desktop/PDFdrawings-MCP/InputDocs/Drawings/
• 사양: ~/Desktop/PDFdrawings-MCP/InputDocs/TextDocs/

문서를 추가한 후 다음을 실행합니다.

🏗️ Claude와 함께 ClaudeHopper 사용하기

Claude 데스크톱 앱에서 다음 예시 질문을 풀어보세요.

🛠️ 기술 아키텍처

ClaudeHopper는 건설 문서를 처리하기 위해 다단계 파이프라인을 사용합니다.

1. 문서 분석 : PDF 문서는 구조와 콘텐츠 유형에 따라 분석됩니다.
2. 메타데이터 추출 : AI를 이용한 프로젝트 정보, 도면 유형, 분야 추출
3. 콘텐츠 청킹 : 컨텍스트를 유지하기 위한 문서의 지능적 분할
4. 이미지 추출 : PDF에서 도면 이미지 식별 및 추출
5. 벡터 임베딩 : 텍스트와 이미지에 대한 의미적 표현 생성
6. 데이터베이스 저장소 : 벡터 검색 기능을 위한 로컬 LanceDB 저장소

👀 이미지 검색 테스트

이미지 검색 기능을 테스트하려면 제공된 테스트 스크립트를 사용할 수 있습니다.

이렇게 하면:

• 애플리케이션을 빌드하세요
• 필수 종속성(예: pdfimages )을 확인하세요.
• 도면 디렉토리의 이미지로 데이터베이스를 시드합니다.
• 이미지 검색에 대한 일련의 테스트 쿼리를 실행합니다.

개별 테스트 명령을 실행할 수도 있습니다.

📝 사용 가능한 검색 도구

ClaudeHopper는 여러 가지 전문 검색 기능을 제공합니다.

• catalog_search : 프로젝트, 분야, 도면 유형 등으로 문서를 찾습니다.
• chunks_search : 문서 내 특정 콘텐츠 찾기
• all_chunks_search : 전체 문서 컬렉션에서 검색
• image_search : 텍스트 설명과 시각적 유사성을 기반으로 그림 찾기

이미지 검색 기능을 사용한 예는 image_search_examples.md 파일에서 확인할 수 있습니다.

📜 라이센스

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