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

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: Keystone MCP Server

🚀 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

1. Descargar Claude Hopper

2. 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:

1. Análisis de documentos : los documentos PDF se analizan en cuanto a estructura y tipo de contenido.

2. Extracción de metadatos : extracción asistida por IA de información del proyecto, tipos de dibujos y disciplinas

3. Fragmentación de contenido : división inteligente de documentos para mantener el contexto

4. Extracción de imágenes : identificación y extracción de imágenes de dibujos de archivos PDF

5. Incrustación vectorial : creación de representaciones semánticas para texto e imágenes

6. 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 .

📜 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.