Claudehopper (Construction Document Analysis)

🚀 🏗️ ClaudeHopper - 人工智能驅動的建築文檔助手

ClaudeHopper 是一款專業的模型上下文協議（MCP）服務器，它支持Claude及其他大語言模型（LLMs）與建築圖紙、文檔和規範直接交互。藉助先進的基於檢索的增強生成（RAG）和混合搜索功能，你能夠輕鬆就施工圖提問、查找特定細節並分析技術規範。

🚀 快速開始

先決條件

• Node.js 18+
• Ollama，用於本地AI模型
  • 需要的模型：nomic-embed-text、phi4、clip
• Claude桌面應用程序
• 圖像提取（可選）：Poppler Utils (pdfimages命令)

一鍵設置

1. 下載ClaudeHopper。
2. 運行安裝腳本：

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

此操作會：

• 創建必要的目錄結構。
• 安裝所需的AI模型。
• 處理你的建築圖紙。
• 配置Claude桌面應用程序以使用ClaudeHopper。

添加文檔

將你的建築文檔放置在以下文件夾中：

• 圖紙：~/Desktop/PDFdrawings-MCP/InputDocs/Drawings/
• 規範：~/Desktop/PDFdrawings-MCP/InputDocs/TextDocs/ 添加文檔後，運行：

./process_pdfdrawings.sh

✨ 主要特性

• 🔍 基於向量的搜索，專為建築圖紙、計劃和規範進行了優化。
• 🖼️ 基於文本描述的圖像檢索，可用於查找相似圖紙。
• 🏢 提供專門針對建築行業文檔格式的元數據提取功能。
• 📊 通過智能文件分塊實現高效的令牌使用。
• 🔒 通過本地存儲和處理確保安全性。
• 📈 支持多種圖紙類型和建築學科（結構、土木、建築等）。

💻 使用示例

在Claude桌面應用程序中嘗試以下示例問題：

“我們有哪些建築圖紙用於該項目？”
“顯示基礎系統的結構細節”
“查找顯示混凝土基礎及其尺寸的圖紙”
“搜索提升站佈局圖”
“Interior paint（室內塗裝）的規範是什麼？”
“查找所有討論防火系統的內容”

🔧 技術細節

技術架構

ClaudeHopper 使用一個多階段管道來處理建築文檔：

1. 文檔分析：分析PDF文檔的結構和內容類型。
2. 元數據提取：通過AI輔助從文檔中提取項目信息、圖紙類型和學科。
3. 內容分塊：智能分割文檔以保持上下文。
4. 圖像提取：識別並提取PDF中的圖紙圖像。
5. 向量嵌入：創建文本和圖像的語義表示。
6. 數據庫存儲：將數據存儲在數據庫中。

數據庫說明

• 表結構：
  • documents 表：存儲文檔的基本信息（如文件名、內容摘要等）。
  • metadata 表：存儲提取的元數據信息（如作者、日期等）。
  • vectors 表：存儲向量表示以便進行相似性搜索。

📄 許可證

本項目採用MIT許可證。

⚠️ 重要提示

確保安裝所有必要的依賴項，包括Node.js和Ollama。

💡 使用建議

在處理大量文檔時，建議優化硬件配置以提高性能。如需進一步支持或定製，請參考項目文檔或聯繫維護團隊。

歡迎使用ClaudeHopper！如需更多幫助，請隨時查看我們的文檔或與我們聯繫。