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

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

✨ 특징

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

🚀 빠른 시작

필수 조건

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

원클릭 설정

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

지엑스피1

이렇게 하면:

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

문서 추가

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

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

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

./process_pdfdrawings.sh

🏗️ Claude와 함께 ClaudeHopper 사용하기

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

"What architectural drawings do we have for the project?"
"Show me the structural details for the foundation system"
"Find drawings that show a concrete foundation with dimensions"
"Search for lift station layout drawings"
"What are the specifications for interior paint?"
"Find all sections discussing fire protection systems"

🛠️ 기술 아키텍처

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

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

👀 이미지 검색 테스트

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

# Make the test script executable
chmod +x test_image_search.sh

# Run the test script
./test_image_search.sh

이렇게 하면:

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

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

# Run the test with the default database location
npm run test:image:verbose

# Run the test with a specific database location
node tools/test_image_search.js /path/to/your/database

📝 사용 가능한 검색 도구

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

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

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

📜 라이센스

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

Integrations