ClaudeHopper - Asistente de documentos de construcción con inteligencia artificial

Node.js 18+ Licencia: MIT

ClaudeHopper es un servidor especializado de Protocolo de Contexto de Modelo (MCP) que permite a Claude y a otros LLM interactuar directamente con documentos de construcción, planos y especificaciones mediante RAG (Recuperación-Generación Aumentada) avanzada y búsqueda híbrida. Haga preguntas sobre sus planos de construcción, localice detalles específicos y analice especificaciones técnicas con facilidad.

✨ Características

🔍 Búsqueda basada en vectores para la recuperación de documentos de construcción optimizada para dibujos, planos y especificaciones CAD
🖼️ Búsqueda visual para encontrar dibujos similares según descripciones textuales
🏢 Extracción de metadatos especializados para formatos de documentos de la industria de la construcción
📊 Uso eficiente de tokens mediante la segmentación y categorización inteligente de documentos
🔒 Seguridad mediante el almacenamiento y procesamiento local de documentos
📈 Soporte para varios tipos de dibujos y disciplinas de construcción (Estructural, Civil, Arquitectónico, etc.)

Related MCP server: MCP Claude Code

🚀 Inicio rápido

Prerrequisitos

Node.js 18+
Ollama para modelos de IA locales
- Modelos requeridos: nomic-embed-text , phi4 , clip
Aplicación de escritorio Claude
Para extracción de imágenes: Poppler Utils (comando pdfimages )

Configuración con un solo clic

Descargar Claude Hopper
Ejecute el script de configuración:

cd ~/Desktop/claudehopper chmod +x run_now_preserve.sh ./run_now_preserve.sh

Esto hará lo siguiente:

Crear la estructura de directorio necesaria
Instalar los modelos de IA necesarios
Tramita tus documentos de construcción
Configurar la aplicación de escritorio Claude para usar ClaudeHopper

Agregar documentos

Coloque sus documentos de construcción en estas carpetas:

Dibujos: ~/Desktop/PDFdrawings-MCP/InputDocs/Drawings/
Especificaciones: ~/Desktop/PDFdrawings-MCP/InputDocs/TextDocs/

Después de agregar documentos, ejecute:

./process_pdfdrawings.sh

🏗️ Usando ClaudeHopper con Claude

Pruebe estas preguntas de ejemplo en la aplicación de escritorio 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"

🛠️ Arquitectura Técnica

ClaudeHopper utiliza un proceso de varias etapas para procesar documentos de construcción:

Análisis de documentos : los documentos PDF se analizan en cuanto a estructura y tipo de contenido.
Extracción de metadatos : extracción asistida por IA de información del proyecto, tipos de dibujos y disciplinas
Fragmentación de contenido : división inteligente de documentos para mantener el contexto
Extracción de imágenes : identificación y extracción de imágenes de dibujos de archivos PDF
Incrustación vectorial : creación de representaciones semánticas para texto e imágenes
Almacenamiento de base de datos : almacenamiento local de LanceDB para capacidades de búsqueda de vectores

👀 Probando la búsqueda de imágenes

Para probar la funcionalidad de búsqueda de imágenes, puede utilizar el script de prueba proporcionado:

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

Esto hará lo siguiente:

Construir la aplicación
Compruebe las dependencias necesarias (como pdfimages )
Sembrar la base de datos con imágenes de su directorio de dibujos
Ejecute una serie de consultas de prueba contra la búsqueda de imágenes

También puede ejecutar comandos de prueba individuales:

# 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

📝 Herramientas de búsqueda disponibles

ClaudeHopper ofrece varias capacidades de búsqueda especializadas:

catalog_search : Encuentra documentos por proyecto, disciplina, tipo de dibujo, etc.
chunks_search : Localiza contenido específico dentro de los documentos
all_chunks_search : busca en toda la colección de documentos
image_search : busca dibujos según su similitud visual con las descripciones textuales

Se pueden encontrar ejemplos del uso de la función de búsqueda de imágenes en el archivo image_search_examples.md .