MCP-Werkzeuge

Diese Seite enthält die Referenz aller Werkzeuge, die der integrierte MCP-Server von Axelix Master KI-Agenten bereitstellt.

Jeder Eintrag beschreibt den Werkzeugnamen, die deklarierten Annotation-Tags, den Aktivierungsstatus, die zum Aufruf berechtigten Rollen und kurz die Funktion. Derselbe Katalog ist im Browser auf der MCP-Seite sichtbar. Diese Seite ist die maßgebliche Referenz für Betreiber, die festlegen, wer was aufrufen darf.

Die Liste setzt voraus, dass der MCP-Server aktiviert ist (axelix.master.mcp-server.enabled=true, der Standard). Bei false wird der Server überhaupt nicht registriert, keines der folgenden Werkzeuge ist erreichbar und der Link MCP wird in der UI ausgeblendet. Siehe MCP-Server konfigurieren.

Werkzeugstatus

Alle folgenden Werkzeuge werden mit Master ausgeliefert und beim Start am MCP-Server registriert. Es gibt keinen Schalter zum Aktivieren oder Deaktivieren einzelner Werkzeuge; der Build legt den Katalog fest. Ein Werkzeug ist nur dann nicht erreichbar, wenn der MCP-Server deaktiviert ist oder der Master-Prozess nicht läuft. Im UI-Katalog zeigt der Statuspunkt jeder Karte diesen aktuellen Registrierungszustand: grün bei registriertem Werkzeug, rot bei derzeitiger Nichtverfügbarkeit.

Werkzeug-Tags

Jedes Werkzeug deklariert vier boolesche Annotation-Tags, die MCP-Clients über zu erwartende Nebenwirkungen informieren. Die folgenden Tags geben die von Axelix-Werkzeugen deklarierten Werte wieder. Es sind Hinweise für den aufrufenden Agenten, keine von Master durchgesetzten Autorisierungsprüfungen.

  • read-only — das Werkzeug verändert keinen Zustand in der Ziel-Spring-Boot-Instanz.
  • idempotent — mehrfache Aufrufe mit denselben Argumenten haben dieselbe Wirkung wie ein einzelner Aufruf.
  • destructive — das Werkzeug kann Daten löschen oder Änderungen anwenden, die sich über die UI nicht rückgängig machen lassen.
  • open-world — das Werkzeug greift über Master und die registrierten Spring-Boot-Instanzen hinaus.

Zugriff nach Rollen

Der MCP-Filter (McpAuthorizationFilter) authentifiziert den Agenten wie die UI eine Browsersitzung. Die unterstützten Zugangsdatenverfahren beschreibt Authentifizierung am MCP-Server.

Katalog

Der folgende Katalog zeigt die derzeit mit Master ausgelieferten MCP-Werkzeuge. Weitere Werkzeuge werden aktiv entwickelt; die Liste wächst mit künftigen Releases.

Die Spalte Seit nennt das erste Axelix-Master-Release eines Werkzeugs. 1.0.0 ist das erste Axelix-Release; so markierte Werkzeuge sind von Anfang an enthalten. Eine mit upcoming markierte Version ist noch nicht veröffentlicht: Das Werkzeug wird im nächsten Axelix-Release verfügbar, unabhängig davon, ob dies ein Minor- oder Major-Release ist.

Instanzen

Das einzige Werkzeug dieser Gruppe liefert Masters vollständiges Verzeichnis verwalteter Spring-Boot-Instanzen. Es ist der Einstiegspunkt für Aufgaben wie „Dienst anhand des Namens finden und seine instanceId ermitteln“. Alle anderen Werkzeuge benötigen diese instanceId.

Siehe auch: Wallboard-Anleitung.

TitelWerkzeugnameSeitTagsErlaubte RollenBeschreibung
InstanzübersichtgetInstances1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Momentaufnahme aller verwalteten Instanzen: lesbare Dienstnamen mit Zuordnung zu instanceId, Echtzeitstatus (UP/DOWN), Spring-Boot-/Java-Versionen, Bereitstellungsdauer und Git-Commit-SHA.

getWallboard wurde in getInstances umbenannt

VeröffentlichtVerfügbar seit Version: 1.3.0

Bis einschließlich Axelix 1.2.x hieß dieses Werkzeug getWallboard. Ab Axelix 1.3.0 heißt es getInstances; getWallboard existiert nicht mehr. Verhalten, Parameter und Antwort des Werkzeugs bleiben unverändert.

KI-Agenten ermitteln beim Verbindungsaufbau die Werkzeuge des MCP-Servers und übernehmen den neuen Namen automatisch. Rufen Sie das Werkzeug direkt über seinen Namen auf, etwa aus eigenen Skripten oder Agentenanweisungen, ersetzen Sie getWallboard durch getInstances.

Instanz untersuchen

Reine Leseansichten einer einzelnen Spring-Boot-Instanz: Spring Beans, Environment-Eigenschaften, @ConfigurationProperties-Beans, Autokonfigurationsbericht und registrierte geplante Tasks. Jedes Werkzeug dieser Gruppe erhält eine über getInstances ermittelte instanceId.

Siehe auch: Beans, Environment-Eigenschaften, Konfigurationseigenschaften, Bedingungen, Geplante Tasks, Dienstprofil-Anleitung.

TitelWerkzeugnameSeitTagsErlaubte RollenBeschreibung
Bean-ÜbersichtgetInstanceBeans1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Listet alle Spring Beans der Instanz mit Typ und Abhängigkeiten auf.
EigenschaftengetInstanceEnvironment1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Liefert das vollständige Environment: Anwendungseigenschaften, Systemeigenschaften und Umgebungsvariablen; hilfreich bei Fragen zu @Value und @ConditionalOnProperty.
Konfigurationseigenschafts-BeansgetInstanceConfigProps1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Liefert alle @ConfigurationProperties-Beans der Instanz mit ihren gebundenen Werten.
@Conditional-ÜbersichtgetInstanceConditions1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Konfigurationsbericht: welche Spring-Boot- und eigenen Konfigurationen angewandt oder übersprungen wurden und warum.
Geplante TasksgetInstanceScheduledTasks1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Listet in der Instanz registrierte @Scheduled-Tasks mit Cron, fester Rate, fester Verzögerung sowie eigene Tasks auf.
LogsgetInstanceLogs1.3.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Liefert die neuesten Log-Einträge der Instanz (alle gepufferten oder nur die angeforderte Anzahl), einschließlich Stacktraces protokollierter Ausnahmen.

Caches

Alle Cache-Manager und Caches einer Spring-Boot-Instanz untersuchen und Einträge entfernen: entweder aus allen Caches aller Cache-Manager zugleich oder aus einem bestimmten benannten Cache in einem ausgewählten Cache-Manager.

Siehe auch: Caches.

TitelWerkzeugnameSeitTagsErlaubte RollenBeschreibung
Cache-ÜbersichtgetAllCaches1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Listet alle Cache-Manager und ihre Caches mit dem jeweiligen Flag enabled auf. Ausgangspunkt für Cache-Aufgaben: Namenszuordnung zu Managern, Statusprüfungen und Auflösung von Mehrdeutigkeiten.
Alle Caches leerenclearAllCaches1.0.0read-only: false
idempotent: true
destructive: true
open-world: false
EDITOR
ADMIN
SUPER_ADMIN
Entfernt alle Einträge aus allen Caches aller Cache-Manager der angegebenen Instanz. Umfassende destruktive Operation, nur für die ausdrückliche Aufforderung zum Leeren aller Caches gedacht.
Bestimmten Cache leerenclearSpecificCacheEntity1.0.0read-only: false
idempotent: true
destructive: true
open-world: false
EDITOR
ADMIN
SUPER_ADMIN
Leert den gesamten benannten Cache im angegebenen Cache-Manager und entfernt alle seine Einträge. Andere Caches bleiben unverändert.

Loggers

Den Logger-Baum einer Spring-Boot-Instanz lesen — einzelne Logger, Logger-Gruppen und verfügbare Log-Level — und Level zur Laufzeit ändern: für einen einzelnen Logger, eine gesamte Logger-Gruppe oder durch Zurücksetzen auf den in der Anwendung definierten Standard.

Siehe auch: Loggers.

TitelWerkzeugnameSeitTagsErlaubte RollenBeschreibung
Verfügbare Log-LevelgetAvailableLoggingLevels1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Liefert die von der Instanz akzeptierten Log-Level (etwa TRACE, DEBUG, INFO, WARN, ERROR, OFF). Dient zur Prüfung von Eingaben vor einer Level-Änderung.
Logger-GruppenübersichtgetLoggerGroupsFeed1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Listet jede konfigurierte Logger-Gruppe mit Mitgliedern und dem aktuell für die Gruppe gesetzten Level auf.
Logger-ÜbersichtgetLoggersFeed1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Listet jeden in der Instanz konfigurierten einzelnen Logger mit seinem aktuell wirksamen Log-Level auf.
Logger findenfindLoggersByName1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Sucht einen oder mehrere einzelne Logger anhand des vollständigen Namens oder eines Namensteils. Liefert für jeden Treffer konfigurierte und wirksame Level.
Logger-Gruppe findenfindGroupsByName1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Sucht eine oder mehrere Logger-Gruppen anhand des vollständigen Namens oder eines Namensteils. Liefert Namen, Level und Mitglieder jeder Gruppe.
Logger-Level ändernchangeLoggingLevelByLoggerName1.0.0read-only: false
idempotent: true
destructive: true
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Setzt das Log-Level eines bestimmten einzelnen Loggers. Verwenden Sie zuerst Logger finden, wenn der Name unklar ist.
Gruppen-Logger-Level ändernchangeLoggingLevelByGroupName1.0.0read-only: false
idempotent: true
destructive: true
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Setzt das Log-Level aller Logger einer Gruppe. Verwenden Sie zuerst Logger-Gruppe finden, wenn der Gruppenname unklar ist.
Logger-Level zurücksetzenresetLoggingLevelByLoggerName1.0.0read-only: false
idempotent: true
destructive: true
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Setzt das Level eines einzelnen Loggers auf den in der Anwendungskonfiguration deklarierten Standard zurück. Zurücksetzen auf Gruppenebene ist nicht verfügbar.

Persistenzanalysen

Von Axelix erkannte Persistenzprobleme in der Datenzugriffsschicht einer Anwendung. Anders als alle obigen Werkzeuge werden diese durch die Build-Koordinaten der Anwendung adressiert: groupId und artifactId (G und A der GAV-Koordinate), die beide erforderlich sind, statt einer instanceId. Sie lesen den erfassten Anwendungssnapshot, statt eine laufende Instanz abzufragen.

Siehe auch: Transaktionskontrolle.

TitelWerkzeugnameSeitTagsErlaubte RollenBeschreibung
TransaktionsprofilgetApplicationTransactionsProfile1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Die in Transaktionsmethoden (@Transactional, TransactionTemplate usw.) der Anwendung erkannten N+1-Lazy-Loading- und In-Memory-Paginierungsprobleme. Optional auf eine Klasse (className) oder Methode (className + methodName) eingrenzbar.
Entity-ProfilgetApplicationEntitiesProfile1.0.0read-only: true
idempotent: true
destructive: false
open-world: false
VIEWER
EDITOR
ADMIN
SUPER_ADMIN
Die von Axelix erfassten JPA-Entities und ihre erkannten Beziehungs-Mapping-Probleme (Eager Fetching, listenbasiertes @ManyToMany, Cascade REMOVE/ALL, unidirektionales @OneToMany). Optional über entityName auf eine Entity eingrenzbar.

Weiterführende Informationen

Auf dieser Seite

Auf GitHub bearbeitenProblem melden