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 许可证保护。