HALCON知识MCP和爬虫
HALCON技术文档摄取和模型上下文协议(MCP)服务的统一存储库。此项目允许您抓取本地HALCON安装,将其索引到矢量数据库中,并通过MCP服务器将该知识提供给LLM。
项目结构
server/:提供混合搜索工具的高性能MCP服务器。crawler/:解析HALCON文档、SDK头文件和HDevelop示例的摄入管道。shared/:两个组件使用的通用数据库模式、连接逻辑和配置。data/:(Git忽略)LanceDB矢量数据库的持久存储。
先决条件
- HALCON安装:您必须在本地安装HALCON的许可版本。
- Docker和NVIDIA容器工具包:GPU加速爬行所需。
- 数据装载:爬网程序需要访问您的HALCON安装路径。
快速开始
1.索引知识库(GPU)
首先,使用爬虫从本地HALCON安装生成矢量数据库。
更新您的 docker-compose.yml 要挂载HALCON路径,请运行:
docker compose up halcon-crawler2.启动MCP服务器(CPU)
一旦 ./data 目录已填充,启动服务器:
docker compose up -d halcon-mcp服务器将在以下时间可用 http://localhost:8000.
Docker服务
| 服务 | Dockerfile | 优化 | 目的 |
|---|---|---|---|
halcon-mcp | Dockerfile.cpu | 仅CPU | 向LLM提供搜索查询。 |
halcon-crawler | Dockerfile.gpu | NVIDA/CUDA | 高速文档摄取和嵌入。 |
可用的MCP工具
search_halcon_knowledge:跨索引的混合搜索(语义+FTS)。get_kb_info:加载的知识库的元数据和统计数据。system_status:实时健康和性能指标。
配置
所有配置均通过以下方式管理 .env。参见 .env.example 查看可用选项。
关键变量:
HALCON_KNOWLEDGE_DB_PATH:LanceDB存储的路径(默认值:/app/data).HALCON_VERSION:目标HALCON版本(例如。,24.11).
许可与免责声明
MIT许可证。
HALCON是MVTec Software GmbH的注册商标。该项目是一个独立的工具,不隶属于MVTec Software GmbH,也不由其背书或赞助 不 分发任何HALCON二进制文件或专有文档。
