Claudehopper

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

ClaudeHopper 是一款專為建築領域打造的工具，它作為專業的 Model Context Protocol (MCP) 服務器，藉助先進的 RAG（檢索增強生成）和混合搜索技術，讓 Claude 及其他大語言模型能夠直接與建築圖紙、文檔和規範進行交互。通過它，用戶可以輕鬆對建築圖紙提問、定位特定細節信息以及分析技術規範，極大地提高了建築文檔查詢的效率。

✨ 主要特性

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

🚀 快速開始

先決條件

• 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 桌面應用程序中，您可以嘗試提出以下示例問題：

“我們有哪些建築圖紙？”
“顯示地基系統的結構細節”
“查找顯示混凝土基礎及其尺寸的圖紙”
“搜索給排水站佈局圖”
“建築塗料的規範是什麼？”
“查找所有討論防火系統的內容”

🔧 技術細節

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

1. 文檔分析：對 PDF 文檔的結構和內容類型進行分析。
2. 元數據提取：藉助 AI 輔助提取項目信息、圖紙類型、學科等內容。
3. 內容分塊：進行智能的文檔分塊和分類。
4. 圖像預處理：優化圖像質量，使其適合 AI 模型處理。
5. 模型推理：使用 Claude 進行上下文理解。

📋 測試圖像搜索

要測試圖像搜索功能，請運行以下命令：

python test_image_search.py

請確保安裝了必要的依賴項，並按照腳本中的說明進行操作。

📄 許可證

此項目受 MIT 許可證保護。