🏗️ ClaudeHopper-人工智能建筑文档助理
](https://nodejs.org/en/) 
ClaudeHopper是一个专门的模型上下文协议（MCP）服务器，它使Claude和其他LLM能够通过高级RAG（检索增强生成）和混合搜索直接与施工文档、图纸和规范进行交互。询问有关施工图的问题，找到具体细节，轻松分析技术规范。
✨ 特性
- 🔍 基于矢量的建筑文档检索搜索，针对CAD图纸、计划和规范进行了优化
- 🖼️ 基于文本描述进行视觉搜索以查找相似的图纸
- 🏢 建筑行业文档格式的专业元数据提取
- 📊 通过智能文档分块和分类高效使用令牌
- 🔒 通过本地文档存储和处理实现安全
- 📈 支持各种图纸类型和施工专业（结构、土建、建筑等）
🚀 快速开始
先决条件
- Node.js 18+
- 没有 用于本地AI模型
- 所需型号： nomic-embed-text, phi4, clip
- 克劳德桌面应用程序
- 对于图像提取： Poppler Utils (
pdfimages命令）
一键安装
- 下载ClaudeHopper
- 运行安装脚本：
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桌面应用程序中尝试以下示例问题：
"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文档的结构和内容类型
- 元数据抽取：人工智能辅助提取项目信息、图纸类型、学科
- 内容分块：智能拆分文档以保持上下文
- 图像提取：从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许可证获得许可-请参阅 许可证 文件以获取详细信息。
