🏗️ ClaudeHopper - AI 驱动的建筑文档助手

ClaudeHopper 是一个专门的模型上下文协议 (MCP) 服务器，它使 Claude 和其他 LLM 能够通过高级 RAG（检索增强生成）和混合搜索直接与建筑文档、图纸和规范进行交互。轻松提问有关您的建筑图纸的问题、查找特定细节以及分析技术规范。

✨ 特性

• 🔍 基于向量的建筑文档检索搜索，针对 CAD 图纸、平面图和规范进行了优化
• 🖼️ 可视化搜索，根据文本描述查找相似的图纸
• 🏢 专门的建筑行业文档格式元数据提取
• 📊 通过智能文档分块和分类实现高效的 Token 使用
• 🔒 通过本地文档存储和处理实现安全性
• 📈 支持各种图纸类型和建筑学科（结构、土木、建筑等）

🚀 快速开始

前提条件

• Node.js 18+
• 用于本地 AI 模型的 Ollama
  • 需要的模型：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

🏗️ 将 ClaudeHopper 与 Claude 一起使用

在 Claude 桌面应用程序中尝试以下示例问题：

"我们有哪些项目的建筑图纸？"
"显示地基系统的结构细节"
"查找显示带有尺寸的混凝土基础的图纸"
"搜索提升站布局图纸"
"室内涂料的规格是什么？"
"查找所有讨论消防系统的章节"

🛠️ 技术架构

ClaudeHopper 使用多阶段管道来处理建筑文档：

1. 文档分析：分析 PDF 文档的结构和内容类型
2. 元数据提取：AI 辅助提取项目信息、图纸类型、学科
3. 内容分块：智能拆分文档以保持上下文
4. 图像提取：从 PDF 中识别和提取图纸图像
5. 向量嵌入：为文本和图像创建语义表示
6. 数据库存储：用于向量搜索功能的本地 LanceDB 存储

👀 测试图像搜索

要测试图像搜索功能，您可以使用提供的测试脚本：

# 使测试脚本可执行
chmod +x test_image_search.sh

# 运行测试脚本
./test_image_search.sh

这将：

• 构建应用程序
• 检查所需的依赖项（如 pdfimages）
• 使用来自您的图纸目录的图像来填充数据库
• 针对图像搜索运行一系列测试查询

您还可以运行单个测试命令：

# 使用默认数据库位置运行测试
npm run test:image:verbose

# 使用特定数据库位置运行测试
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 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。