GGU-CONNECT - Command Line Interface (CLI)¶

GGU-CONNECT CLI¶

Das GGU-CONNECT Command Line Interface (CLI) ermoeglicht die Automatisierung von geotechnischen Daten-Workflows ueber die Kommandozeile. Es ist ein schlanker Wrapper um die GGU-CONNECT-Bibliothek und stellt Import-, Export-, Such-, Validierungs- und Generierungsfunktionen bereit.

Die CLI kann sowohl interaktiv als auch als MCP-Server (Model Context Protocol) fuer KI-Assistenten wie Claude Code eingesetzt werden.

Aufruf¶

ggu-connect.exe <befehl> <unterbefehl> [optionen]
ggu-connect.exe --mcp                  # MCP-Server-Modus starten
ggu-connect.exe --help                 # Hilfe anzeigen
ggu-connect.exe --version              # Version anzeigen

Allgemeine Optionen¶

Option	Beschreibung
`--db <verbindung>`	Datenbankverbindung: `access:pfad.mdb`, `mssql:host/db` oder `pg:host/db`
`--db-profile <name>`	Datenbankprofil aus den GGU-CONNECT-Einstellungen (Alternative zu `--db`)
`--settings <datei>`	Verwendet die angegebene GGU-CONNECT-Einstellungsdatei (XML) statt der Standarddatei im AppData-Verzeichnis. Relative Pfade beziehen sich auf das aktuelle Arbeitsverzeichnis.
`--project <guid>`	Projekt-GUID
`--output <pfad>`	Ausgabepfad
`--dry-run`	Vorschau ohne Aenderungen
`--format json\\|text\\|table`	Ausgabeformat (Standard: text)

Datenbankverbindungen¶

Die CLI unterstuetzt drei Datenbanktypen:

Typ	Verbindungsformat	Beispiel
MS Access	`access:pfad/zur/datei.mdb`	`access:C:/Projekte/Baustelle.mdb`
MS SQL Server	`mssql:host/datenbankname`	`mssql:server01/GGUConnect`
PostgreSQL	`pg:host/datenbankname`	`pg:localhost/gguconnect`

Alternativ koennen Datenbankverbindungen als Profile mit --db-profile referenziert werden. Die CLI liest die konfigurierten Datenbankverbindungen automatisch aus der GGU-CONNECT-Appsettings.xml im AppData-Verzeichnis von GGU-CONNECT. Es ist keine separate Konfiguration erforderlich.

Mit --settings <datei> laesst sich stattdessen eine beliebige Einstellungsdatei angeben — nuetzlich, um pro Umgebung ein eigenes Set an Verbindungsprofilen zu verwenden, ohne die Standarddatei zu ueberschreiben. Existiert die Datei nicht, wird das Standardverhalten (keine Profile) verwendet.

Befehle¶

Import-Befehle¶

Befehl	Beschreibung	Enterprise
`import abbr-lines`	Kuerzellisten (Bodenschichten) aus CSV importieren
`import coordinates`	Bohrungskoordinaten aus CSV importieren
`import sep3`	Daten aus SEP3/Geodin-MDB importieren
`import bml`	Daten aus BoreholeML-XML importieren
`import xml`	Daten aus GGU-CONNECT-XML importieren
`import stratig`	Daten aus GGU-STRATIG .bop-Datei importieren
`import ggu-cloud`	Daten aus GGU-Cloud-Format importieren
`import korfin`	Daten aus GGU-Korfin .ground-Datei importieren	Ja
`import pdf`	Bohrdaten aus PDF-Berichten extrahieren (ext. Extractor)	Ja
`import flextext`	Bohrungen aus CSV/Text mit flexibler Spaltenzuordnung importieren. KI-gestuetzte Formaterkennung optional.	Ja (KI)

Export-Befehle¶

Befehl	Beschreibung	Enterprise
`export csv`	Daten als CSV exportieren (Bohrungen, Proben, Details)
`export excel`	Daten als Excel exportieren (mit Vorlage)
`export kml`	Bohrungen als KML fuer Google Earth/Maps exportieren
`export sep3`	Daten als SEP3/Geodin-MDB exportieren
`export word`	Projektdaten als Word-Dokument exportieren (mit Vorlage). KI-gestuetzte Textplatzhalter optional.	Ja (KI)
`export ggu-app`	Export in GGU-Anwendungsformate (Stratig, Borelog). Modi: native, open, pdf
`export korfin`	Daten als GGU-Korfin .ground-Datei exportieren	Ja
`export dgm`	Gelaendemodell (DGM) als LandXML exportieren

Such-Befehle¶

Befehl	Beschreibung
`search projects`	Projekte in der Datenbank suchen und auflisten (liefert GUIDs)
`search drillings`	Bohrungen in einem Projekt suchen und filtern (Name, BBox, Tiefe)
`search soillayers`	Bodenschichten suchen und filtern
`search samples`	Proben suchen und filtern
`search groundwater`	Grundwasserstaende suchen und filtern
`search consistencies`	Konsistenzen suchen und filtern

Validierung¶

Befehl	Beschreibung
`validate sep3`	Projektdaten gegen SEP3-Konformitaetsregeln pruefen

Generierung¶

Befehl	Beschreibung
`generate ground-volume`	Automatisches Baugrundschichtenmodell aus Bodenschichtanalyse generieren

Datenbank¶

Befehl	Beschreibung
`create database`	Neue leere GGU-CONNECT Access-Datenbank aus Vorlage erstellen

Konfiguration¶

Befehl	Beschreibung
`config profile-list`	Alle Datenbankverbindungsprofile auflisten
`config profile-get`	Details eines Profils anzeigen
`config profile-add`	Neues Datenbankprofil anlegen (access, mssql, postgresql)
`config profile-update`	Bestehendes Profil aendern
`config profile-delete`	Profil loeschen

MCP-Server (KI-Integration)¶

Die CLI kann als MCP-Server (Model Context Protocol) gestartet werden, um KI-Assistenten wie Claude Code den direkten Zugriff auf geotechnische Daten zu ermoeglichen.

Starten¶

ggu-connect.exe --mcp

Kommunikation erfolgt ueber stdin/stdout mit JSON-RPC 2.0 (Protokollversion 2024-11-05).

Konfiguration in Claude Code¶

In der .mcp.json im Workspace-Stammverzeichnis:

{
  "mcpServers": {
    "ggu-connect": {
      "command": "C:/pfad/zu/GGU.Apps.ConnectCLI.exe",
      "args": ["--mcp"]
    }
  }
}

MCP-Tools¶

Alle CLI-Befehle stehen als MCP-Tools zur Verfuegung. Die Tool-Namen verwenden Unterstriche statt Leerzeichen.

MCP-Tool	Entspricht CLI-Befehl
`create_database`	`create database`
`import_abbr_lines`	`import abbr-lines`
`import_coordinates`	`import coordinates`
`import_sep3`	`import sep3`
`import_bml`	`import bml`
`import_xml`	`import xml`
`import_stratig`	`import stratig`
`import_ggu_cloud`	`import ggu-cloud`
`import_korfin`	`import korfin`
`import_pdf`	`import pdf`
`import_flextext`	`import flextext`
`export_csv`	`export csv`
`export_excel`	`export excel`
`export_kml`	`export kml`
`export_sep3`	`export sep3`
`export_word`	`export word`
`export_ggu_app`	`export ggu-app`
`export_korfin`	`export korfin`
`validate_sep3`	`validate sep3`
`search_projects`	`search projects`
`search_drillings`	`search drillings`
`search_soillayers`	`search soillayers`
`search_samples`	`search samples`
`search_groundwater`	`search groundwater`
`search_consistencies`	`search consistencies`
`generate_ground_volume`	`generate ground-volume`
`config_profile_list`	`config profile-list`
`config_profile_get`	`config profile-get`
`config_profile_add`	`config profile-add`
`config_profile_update`	`config profile-update`
`config_profile_delete`	`config profile-delete`

MCP-Beispiel¶

{
  "name": "search_drillings",
  "arguments": {
    "db": "access:C:/Projekte/Baustelle.mdb",
    "project": "12345678-1234-1234-1234-123456789012",
    "name": "BK-*"
  }
}

Antwort:

{
  "success": true,
  "exitCode": 0,
  "output": "..."
}

Konfiguration¶

Die CLI benoetigt keine separate Konfigurationsdatei. Stattdessen liest sie alle relevanten Einstellungen automatisch aus der bestehenden GGU-CONNECT-Appsettings.xml im AppData-Verzeichnis:

%APPDATA%\GGU-Software\GGU-CONNECT\GGU-CONNECT-Appsettings.xml

Daraus werden automatisch uebernommen:

Datenbankverbindungen (SQL-Profile und letzte Access-Verbindungen)
Pfade zu GGU-Anwendungen (STRATIG, BORELOG, KORFIN)
Vorlagenpfade (Templates fuer Stratig, Borelog)
LLM-Konfiguration (API-Keys und Modelleinstellungen fuer KI-Funktionen)

Es genuegt, GGU-CONNECT einmal regulaer einzurichten -- die CLI verwendet dann dieselben Einstellungen.

Umgebungsvariablen (optional)¶

Fuer Sonderfaelle (z.B. CI/CD-Pipelines) koennen Einstellungen per Umgebungsvariable ueberschrieben werden:

Variable	Beschreibung
`GGU_CONNECT_RESOURCES`	Basispfad fuer Ressourcen
`GGU_DATABASE_TEMPLATE`	Pfad zur Datenbank-Vorlage (.mdb)
`GGU_PDF_EXTRACTOR`	Pfad zum PDF-Extractor
`GGU_STRATIG_EXE`	Pfad zu GGU-STRATIG
`GGU_BORELOG_EXE`	Pfad zu GGU-BORELOG
`GGU_KORFIN_EXE`	Pfad zu GGU-KORFIN

Enterprise-Edition¶

Einige Funktionen erfordern die Enterprise-Edition von GGU-CONNECT (Produktcode 2350). Bei Nutzung mit Basic-Edition wird ein entsprechender Hinweis ausgegeben. Betroffen sind:

import korfin / export korfin
import pdf (PDF-Datenextraktion)
import flextext (KI-gestuetzte Formaterkennung)
export word (KI-gestuetzte Textplatzhalter)

Beispiel-Workflows¶

Daten aus SEP3 importieren und als Excel exportieren¶

# 1. Projekt suchen
ggu-connect search projects --db access:Baustelle.mdb

# 2. SEP3-Daten importieren
ggu-connect import sep3 --input Geodin-Export.mdb --db access:Baustelle.mdb --project <GUID>

# 3. Als Excel exportieren
ggu-connect export excel --db access:Baustelle.mdb --project <GUID> --output Uebersicht.xlsx --template Vorlage.xlsx

Bohrprofile als STRATIG-Dateien ausgeben¶

ggu-connect export ggu-app --db access:Baustelle.mdb --project <GUID> --output ./profile/ --app stratig

Bohrungen auf Google Earth anzeigen¶

ggu-connect export kml --db access:Baustelle.mdb --project <GUID> --output Bohrungen.kml --open