🏗️ ClaudeHopper - AI-Powered Construction Document Assistant
2025.03.13
1
TypeScript建筑文档处理AI辅助设计文档检索内容生成开发效率
ClaudeHopper 是一个基于 AI 的 MCP 服务器，专门用于处理建筑文档、图纸和规范。它通过先进的 RAG（检索增强生成）和混合搜索技术，使 Claude 和其他大型语言模型能够直接与建筑文档进行交互。用户可以通过自然语言提问来查询建筑图纸、定位特定细节和分析技术规范。
View on GitHub
Overview
基本能力
产品定位
ClaudeHopper 是一个 AI 驱动的建筑文档助手，专注于建筑行业的文档处理和智能搜索。
核心功能
- 🔍 基于向量的建筑文档检索，优化 CAD 图纸、平面图和规范
- 🖼️ 基于文本描述的视觉搜索，查找相似图纸
- 🏢 针对建筑行业文档格式的专用元数据提取
- 📊 通过智能文档分块和分类实现高效令牌使用
- 🔒 本地文档存储和处理保障安全性
- 📈 支持多种图纸类型和建筑学科（结构、土木、建筑等）
适用场景
- 查询建筑图纸信息
- 定位结构细节
- 搜索特定规范的图纸
- 分析技术规范
- 基于描述查找相似图纸
工具列表
catalog_search: 按项目、学科、图纸类型等查找文档chunks_search: 在文档中定位特定内容all_chunks_search: 在整个文档集合中搜索image_search: 基于文本描述的视觉相似性查找图纸
常见问题解答
- 需要安装 Ollama 和特定 AI 模型
- 需要 Poppler Utils 进行图像提取
- 文档需要放置在特定目录下进行处理
使用教程
使用依赖
- Node.js 18+
- Ollama（需要安装以下模型）：
bash ollama pull nomic-embed-text ollama pull phi4 ollama pull clip - Claude Desktop App
- Poppler Utils（用于图像提取）： ```bash # Ubuntu/Debian sudo apt-get install poppler-utils
# macOS brew install poppler ```
安装教程
- 下载 ClaudeHopper
- 运行安装脚本：
bash cd ~/Desktop/claudehopper chmod +x run_now_preserve.sh ./run_now_preserve.sh - 添加文档：
- 将建筑图纸放入
~/Desktop/PDFdrawings-MCP/InputDocs/Drawings/ - 将规范文档放入
~/Desktop/PDFdrawings-MCP/InputDocs/TextDocs/ - 处理文档：
bash ./process_pdfdrawings.sh
调试方式
- 测试图像搜索功能：
bash chmod +x test_image_search.sh ./test_image_search.sh - 运行详细测试：
bash npm run test:image:verbose - 使用特定数据库测试：
bash node tools/test_image_search.js /path/to/your/database