HALCON知识库管理与爬取工具

HALCON知识MCP和爬虫

HALCON技术文档摄取和模型上下文协议（MCP）服务的统一存储库。此项目允许您抓取本地HALCON安装，将其索引到矢量数据库中，并通过MCP服务器将该知识提供给LLM。

项目结构

• server/：提供混合搜索工具的高性能MCP服务器。
• crawler/：解析HALCON文档、SDK头文件和HDevelop示例的摄入管道。
• shared/：两个组件使用的通用数据库模式、连接逻辑和配置。
• data/：（Git忽略）LanceDB矢量数据库的持久存储。

先决条件

1. HALCON安装：您必须在本地安装HALCON的许可版本。
2. Docker和NVIDIA容器工具包：GPU加速爬行所需。
3. 数据装载：爬网程序需要访问您的HALCON安装路径。

快速开始

1.索引知识库（GPU）

首先，使用爬虫从本地HALCON安装生成矢量数据库。

更新您的 docker-compose.yml 要挂载HALCON路径，请运行：

docker compose up halcon-crawler

2.启动MCP服务器（CPU）

一旦 ./data 目录已填充，启动服务器：

docker compose up -d halcon-mcp

服务器将在以下时间可用 http://localhost:8000.

Docker服务

可用的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二进制文件或专有文档。