几何嵌入服务

基于Spring Boot和Qdrant的本地优先几何嵌入服务,用于生成和存储Parasolid几何嵌入,支持相似性搜索和Onshape文档发现。

  • by a-tsygankov
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 a-tsygankov/onshape-mcp-service

使用说明

Parasolid嵌入服务(本地优先)

这个项目是 本地优先 基于Spring Boot+Jetty+Qdrant+ONNX的服务:

  • 连接到本地Onshape开发实例
  • 导出零件的准实体几何图形
  • 运行本地ONNX模型以创建嵌入
  • 在Qdrant中存储嵌入
  • 公开REST API(用OpenAPI记录)用于:
    • Onshape文档/工作区/零件发现
    • 嵌入生成
    • 相似性搜索

模块

  • parasolid-service -Spring Boot 3.3+Jetty REST API
  • geometry-core --准实体/几何分析抽象
  • embedding-engine --ONNX模型加载器和推理
  • vector-db --Qdrant客户端和相似性搜索
  • onshape-client --由OpenAPI生成的Onshape REST客户端

快速开始

  1. 在本地启动Qdrant:

    ./scripts/run-qdrant.sh
    
  2. (可选)启动ONNX模型容器:

  1. 构建并运行Spring Boot服务:

    ./gradlew :parasolid-service:bootRun
    
  2. 打开API文档:

    • Swagger用户界面:http://localhost:8080/swagger-ui.html
    • OpenAPI JSON:http://localhost:8080/v3/api-docs

IntelliJ IDEA设置

运行:

./scripts/setup-idea.sh

安装推荐的插件(Docker、Kubernetes、Spring、OpenAPI等)。

牧场主桌面

Rancher Desktop提供了一个与Docker兼容的CLI。这里的所有脚本都使用 docker compose 只要Docker上下文设置正确,就可以使用Rancher Desktop。