HQbird MCP KI-Assistent
KI-Assistent unter menschlicher Kontrolle
HQbird MCP verbindet Firebird mit einem KI-Assistenten. Sie schreiben in einfachen Worten, und der Assistent wählt die Werkzeuge selbst. Er liest frei. Jede Änderung wartet auf Ihr „Ja“, und eine gefährliche wartet auf die Freigabe auf dem Server selbst.
- 122 Werkzeuge
- 56 nur lesend
- Firebird 2.5–5 Windows und Linux
- 2 Kanäle für die Freigabe
- Audit-Log mit Hash-Kette
Beispiel
Ein Gespräch mit dem Assistenten
Benutzer beschweren sich, dass die Datenbank langsam ist. Der Assistent liest die Daten, findet die Ursache, schlägt eine Aktion vor und wartet auf Ihre Entscheidung. Namen und Zahlen im Beispiel sind erfunden.
Jeder MCP-Client funktioniert: Claude Desktop, Claude Code, Cursor, Codex, ZCode und andere.
Richtlinie · Freigabe
Vier Gefahrenstufen
Jedes Werkzeug hat eine Stufe. Der MCP-Server prüft die Stufe und die Bedingungen selbst, bevor der Aufruf ausgeführt wird. Ein Aufruf, der etwas ändert, liefert eine Freigabeanfrage statt eines Ergebnisses. Der Assistent kann diese Prüfung nicht umgehen.
Wählen Sie ein Werkzeug und sehen Sie, welchen Weg sein Aufruf nimmt.
| Stufe | Werkzeuge | Beispiele | Wie sie freigegeben wird |
|---|---|---|---|
| 0 · Lesen | 51 | Sitzungen, Transaktionen, Abfrageplan, gstat, firebird.log, Agent-Berichte | Nicht erforderlich. Nur-Lese-Transaktion. |
| 1 · Änderung | 31 | DML und DDL, Backup, Test-Restore, Sweep, Benutzer und Rechte, Beenden einer Sitzung | Im Chat: Anfragenummer und Token, dann fb_confirm. |
| 2 · Gefährliche Operation | 14 | Datenbank aus einem Backup ersetzen, firebird.conf bearbeiten, Firebird stoppen und neu starten | Nur auf dem Server: der Befehl fbmcp ctl approve. Unter Windows können Sie auch ein Tray-Fenster installieren. |
| 3 · Deaktiviert | 1 | Datenbank löschen | Wird nie ausgeführt. |
- VorschauJedes Werkzeug, das eine Freigabe benötigt, akzeptiert
mode: preview. Es zeigt, was getan wird, und tut nichts. - Bedingungen für Stufe 2Jede Operation der Stufe 2 benötigt ein offenes Wartungsfenster für diese Datenbank. Das Ersetzen einer Datenbank aus einem Backup, ein exklusives Fenster und gefährliches SQL benötigen außerdem ein verifiziertes Backup, das nicht älter als 24 Stunden ist. Eine Ablehnung sagt, was fehlt.
- Nur erlaubte WerkzeugeDer Client sieht in der Liste nur, was er verwenden darf: keine Stufe 3 und keine Stufen über dem Maximum seines Schlüssels. Ein direkter Aufruf eines verborgenen Werkzeugs wird abgelehnt.
- Eine Anfrage lebt 15 MinutenEin Versuch, sie über den falschen Kanal freizugeben, verbraucht sie nicht.
fb_cancellöscht die Anfrage. - Keine FreigabeseiteUnd es wird keine geben: Eine Seite, die das Modell erreichen kann, würde den Schutz aushebeln. Nur ein Mensch auf dem Server gibt frei: mit dem Befehl
fbmcp ctl approveoder im Tray-Fenster, falls es installiert ist.
Lesevorgänge laufen in einer Nur-Lese-Transaktion: Firebird selbst blockiert Schreibvorgänge. Für eine zweite Schutzschicht legen Sie einen separaten Nur-Lese-Benutzer ohne Schreibrechte an.
Monitoring · Backups · Rechte
Für DBAs
Der Assistent erledigt, was ein DBA von Hand tut: prüft Sitzungen und Transaktionen, liest Logs, erstellt ein Backup und verifiziert es mit einem Restore, verwaltet Benutzer. Datenbanken werden über ihre id benannt, nicht über den Dateipfad.
| Aufgabe | Werkzeuge | Stufe |
|---|---|---|
| Läuft alles | fb_ping, fb_db_list, fb_db_health, fb_service_status | 0 |
| Sitzungen und lange Transaktionen | fb_sessions, fb_transactions; zum Beenden einer Sitzung — fb_session_kill | 0 · 1 |
| Logs und Statistiken | fb_firebird_log, fb_gstat, fb_lwmonitoring, fb_trends | 0 |
| Backup und Verifikation | fb_backup_start (gbak), fb_backup_nbackup, fb_restore_test | 1 |
| Alte Backups | fb_retention_run: zuerst ein Dry Run; löscht nur verifizierte Backups aus dem eigenen Katalog | 1 |
| Sweep und Datenbankvalidierung | fb_sweep, fb_validate (nur Befunde, keine Reparatur) | 1 |
| Benutzer und Rechte | fb_user_create, fb_grant, fb_revoke; SYSDBA und die eigenen Konten können nicht gelöscht werden | 1 |
| Traces | fb_trace_start nur mit Vorlagen: audit-lite, performance, errors | 1 |
| firebird.conf | fb_config_get, fb_config_diff; zum Bearbeiten — fb_config_set, Firebird wird nicht neu gestartet | 0 · 2 |
| Dienst und Datenbankersetzung | fb_service_restart; fb_restore_replace, die alte Datei bleibt als .pre-restore | 2 |
Nächtliche Backup-Prüfung
Der Zeitplan wird einmal bei der Erstellung freigegeben. Danach läuft er ohne einen Menschen. Jede Nacht erhalten Sie ein verifiziertes Backup. Sie brauchen eines zum Beispiel, um eine Datenbank aus einem Backup zu ersetzen.
- 1Zeitplan
fb_schedule_create, Zielnightly_verify; einmal freigegeben - 2Backupgbak in den Backup-Ordner
- 3Test-Restorein einen Arbeitsordner; die Quelldatenbank wird nicht berührt
- 4✓ Backup verifizierteine Markierung im Backup-Katalog
Das Ersetzen einer Datenbank aus einem Backup und Operationen der Stufe 3 können nicht geplant werden.
Fertige Szenarien
Szenarien schlagen dem Assistenten die Reihenfolge der Schritte vor. Er wendet Änderungen nicht von selbst an.
Abfragen · Indizes · Migrationen
Für Entwickler
Der Assistent in Cursor oder Claude Code kennt Ihr Schema, prüft eine Abfrage, bevor sie ausgeführt wird, und zeigt das Ergebnis als Tabelle direkt im Chat.
- 1Aufgabewas Sie brauchen, in einem Satz
- 2Fakten
fb_schema_list,fb_describe: nur vorhandene Tabellen und Spalten - 3Entwurfein SELECT mit ORDER BY
- 4Prüfung
fb_query_check: kompilieren ohne Ausführen - 5✓ Tabelle im Chat
fb_query: Zeilen, Plan und Statistiken
Ergebnis als Tabelle
In Clients, die MCP Apps unterstützen, wird das Ergebnis von fb_query als sortierbare Tabelle angezeigt. Andere Clients erhalten dieselben Daten als Text.
Standardmäßig 100 Zeilen, höchstens 1000. Die Tabelle bleibt 30 Minuten im Speicher, und nur die Person, die sie angefordert hat, kann sie sehen. Klicken Sie auf einen Spaltenkopf, um zu sortieren.
SELECT full_name, dept_no, salary FROM employee WHERE salary > 60000 ORDER BY salary DESC
Index-Empfehlung
Findet vollständige Tabellenscans und schlägt CREATE INDEX mit einer Schätzung des Nutzens vor. Der Index selbst wird nicht angelegt: Das erledigt fb_write, mit Genehmigung. Nachdem der Index angelegt wurde, wird der Plan erneut geprüft.
Datenbankvergleich
Schema zweier Datenbanken oder einer Datenbank und ihres Snapshots: was anzulegen, zu ändern, zu löschen ist. Daten werden über den Primärschlüssel verglichen; eine große Tabelle wird vom Tool nicht verglichen (standardmäßig mehr als 100.000 Zeilen).
Migrationen
Der Plan zeigt die Stufe jeder Anweisung. Alle Migrationen werden nach einer Genehmigung angewendet; ändert sich eine Datei, ist eine neue Anfrage erforderlich. Der Rollback-Plan wird aus dem aufgebaut, was beim Anwenden der Migrationen aufgezeichnet wurde.
fb_write ermittelt die Stufe jeder Anweisung in einem Skript. Ein Skript, das Anweisungen unterschiedlicher Stufen mischt, wird abgelehnt.
fbagent · Lokale API · 127.0.0.1
fbagent-Daten
Der fbagent-Agent läuft bereits auf dem HQbird-Server. Über MCP erhält der Assistent alles, was der Agent gesammelt hat: den Health-Report, LWM (Light-weight Monitoring), gstat, Traces, Deadlocks, Backup-Status. Er führt außerdem Agent-Jobs aus und ändert deren Einstellungen, unter denselben Stufen und Genehmigungen.
| Was | Tools | Stufe |
|---|---|---|
| Server-Health-Report | fb_agent_status | 0 |
| LWM, gstat, Datenbankmetriken, Traces, Deadlocks | fb_agent_artifact_get, fb_agent_perf_report | 0 |
| Backup-, Sweep- und Restore-Einstellungen | fb_agent_backup_config; Passwörter und Tokens sind ausgeblendet | 0 |
| Einen Agent-Job ausführen | fb_agent_job_run; Backup, Restore und SQL-Skript sind Stufe 2 | 1 · 2 |
| Eine Job-Einstellung ändern | fb_agent_config_set; Anmeldedaten, IDs und Befehle können nicht geändert werden | 2 |
| Firebird über den Agenten neu starten | fb_agent_restart, fb_agent_stop, fb_agent_start | 2 |
| Lizenz und Updates | fb_agent_license, fb_agent_license_set, fb_agent_update_apply, fb_agent_product_update_apply | 0 · 1 · 2 |
- Nur lokalDer Agent akzeptiert Anfragen nur auf 127.0.0.1. Die Agent-Adresse stammt aus der Konfiguration des MCP-Servers, nicht aus dem Chat.
- Token bleibt verborgenDas Agent-Token erscheint weder in der Tool-Ausgabe noch im Audit-Log.
- Agent-Erkennung
fb_agent_discoverfindet Agenten auf dem Server über Windows-Dienste oder systemd-Units. Tokens werden nicht gelesen. - ClusterWenn auf dem Server ein Cluster-Knoten installiert ist, verweigern
fb_agent_restart,fb_agent_stopundfb_agent_startstandardmäßig: Der Knoten steuert Neustarts.fb_service_restartprüft dies nicht, daher nicht auf einem Cluster-Knoten verwenden.
Doppelte Kontrolle. Der MCP-Server genehmigt die Anfrage, und der Agent selbst führt den Job nach seinen eigenen Regeln aus. Das MCP-Log zeigt, wer gefragt hat; die Agent-Logs zeigen, wie es gemacht wurde.
HQbird Cluster · RCM
Replikationscluster über den Assistenten
Der Assistent baut Schritt für Schritt einen Replikationscluster auf: Er aktiviert RCM, öffnet das Pairing-Fenster, verbindet die Hosts, nimmt Datenbanken unter Verwaltung und erstellt eine Kopie für die Replik. Er arbeitet über den Agenten und RCM. Sie müssen sich nicht per SSH auf den Servern anmelden.
Die Regeln sind überall dieselben. Lesezugriffe erfordern keine Bestätigung. Eine Änderung wird im Chat bestätigt. Ein Firebird-Neustart, eine Datenbankkopie auf die Replik, das Entfernen eines Servers aus dem Cluster, Switchover, Failover und die Rückkehr des alten Masters werden auf dem Server bestätigt.
| Was | Tools | Stufe |
|---|---|---|
| Cluster-Status auf dem Server | fb_agent_cluster: frei, in einem Cluster oder RCM-Owner; Slot und Ports | 0 |
| Cluster-Übersicht in RCM | fb_cluster_status: Knoten, Datenbanken, Befehle, Alerts | 0 |
| Hosts vor dem Verbinden prüfen | fb_cluster_probe: eine Zeile pro Agent, Zertifikat-Fingerprint | 0 |
| Master und Replik vergleichen | fb_cluster_verify: Zeilenanzahl jeder Tabelle | 0 |
| RCM auf dem Server aktivieren | fb_agent_cluster_rcm | 1 |
| Pairing-Fenster | fb_agent_cluster_pairing: Status, 1–24 Stunden geöffnet, schließen | 0 · 1 |
| Hosts verbinden | fb_cluster_link; die Anfrage zeigt Fingerprints zum Vergleichen | 1 |
| Datenbanken und Publikation | fb_cluster_replica_folder, fb_cluster_enroll, fb_cluster_publication | 1 |
| RCM-Passwort | fb_cluster_rcm_password: ein neues Zufallspasswort, nicht im Chat angezeigt | 1 |
| Datenbankkopie auf die Replik | fb_cluster_reinit | 2 |
| Firebird eines Knotens neu starten | fb_cluster_firebird_restart | 2 |
| Einen Server aus dem Cluster entfernen | fb_cluster_unlink | 2 |
| Services: wo der Master ist | fb_cluster_service: Master, Repliken, Router, Probleme, laufende Operation | 0 |
| Einen Service und seine Regel beschreiben | fb_cluster_service_put, fb_cluster_service_policy: Service-Beschreibung, Regel für automatisches Failover | 1 |
| Eine Operation fortsetzen und abbrechen | fb_cluster_resume, fb_cluster_operation_cancel; Abbruch nur vor dem Point of no Return | 1 |
| Switchover | fb_cluster_switchover: geplanter Umzug des Masters, wartet auf das Ende der Operation | 2 |
| Failover | fb_cluster_failover: nur mit ausdrücklicher Zustimmung zu Datenverlust | 2 |
| Den alten Master zurückholen | fb_cluster_rejoin | 2 |
| Einen Service löschen | fb_cluster_service_delete: nur der Eintrag in RCM wird gelöscht | 2 |
- Fertiges Szenario„Cluster aufbauen“: Der Assistent geht Schritt für Schritt vor und zeigt bei jedem Schritt, was er tun wird.
- FingerprintsVor dem Verbinden zeigt der Assistent den Zertifikat-Fingerprint jedes Servers. Vergleichen Sie ihn mit der Zeile aus der Installationszusammenfassung.
- ProbelaufBevor er einen Ordner mit Datenbanken unter Verwaltung nimmt, zeigt der Assistent, welche Datenbanken RCM finden wird.
- Switchover und FailoverDer Assistent startet den Umzug des Masters und verfolgt die Schritte der Operation. Eine Person auf dem Server bestätigt den Start. Failover erfordert außerdem eine ausdrückliche Zustimmung zu Datenverlust. Mehr auf der Cluster-Seite.
HTTPS · API-Schlüssel · Audit
Remote-Modus, Installation und Audit-Log
Der Assistent läuft auf dem PC des Administrators, und der MCP-Server läuft auf dem Datenbankserver. Dazwischen liegen HTTPS und ein API-Schlüssel. Jede Person hat ihren eigenen Schlüssel und ihre eigene maximale Stufe.
- Ein Schlüssel für jede Person
fbmcp ctl apikey new <name> --max-tier 2. Der Wert wird einmal angezeigt. Nach einer Schlüsseländerung funktioniert der alte Schlüssel innerhalb weniger Sekunden nicht mehr. - LimitsPro Schlüssel: gleichzeitige Aufrufe, Aufrufe pro Minute, offene Sitzungen. Über dem Limit lautet die Antwort 429.
- Anleitung auf PortugiesischDie vollständige Anleitung zu Installation und Nutzung ist auch in brasilianischem Portugiesisch verfügbar.
- Autonome AgentenDas Profil
autonomous: standardmäßig nur Lesen. Eine Änderung wartet auf einen Operator auf dem Server;fb_confirmvom Agenten wird abgelehnt. 10 Aufrufe pro Minute. Führen Sie solche Agenten innerhalb des Firmennetzwerks aus. - AdressenEin Schlüssel kann an Adressen gebunden werden (
allow_from). Eine andere Adresse erhält 403 und einen Eintrag im Log.
Installation in HQbird
Der HQbird-Installer installiert den MCP-Server standardmäßig. Ein Server bedient alle Firebird-Linien auf der Maschine. Ein Befehl richtet alles ein, und Sie können ihn erneut ausführen.
- 1HQbird-InstallerWindows oder Linux
- 2fbmcp ctl hqbird-installein Befehl, keine manuellen YAML-Änderungen
- 3Firebird-Linienfindet jede Linie und ihren Agenten
- 4Datenbankendatabases.conf-Aliase und kürzlich verbundene Datenbanken
- 5✓ Dienststart, check, connect.txt-Datei für Clients
Der Remote-Modus wird aktiviert, wenn drei Bedingungen erfüllt sind: Eine Liste der Administratoradressen ist festgelegt (--allow-from), die Firewall läuft und mindestens ein API-Schlüssel existiert. Den Schlüssel erstellen Sie separat. Führen Sie danach erneut fbmcp ctl hqbird-install aus. Der Standardport ist 8650.
Hash-Kette
Jede Entscheidung (erlaubt, ausstehend, genehmigt, abgelehnt) wird ins Protokoll geschrieben. Jeder Eintrag ist mit dem vorherigen verknüpft. Eine Kettenprüfung zeigt, ob ein Eintrag geändert oder gelöscht wurde.
Protokoll abgeschnitten — Server bleibt unten
Wenn das Protokoll abgeschnitten ist oder sein Ende nicht mit dem Kontrolleintrag übereinstimmt, startet der MCP-Server nicht. Das ist ein Hinweis auf Manipulation, und Sie müssen dies untersuchen. Der Befehl fbmcp ctl verify prüft die gesamte Kette.
Über den Agenten
fbagent aktualisiert den MCP-Server: stoppen, ersetzen, starten, prüfen, bei Fehler zurückrollen. Unter Linux wird ein unsignierter Build nicht installiert. Konfiguration und Schlüssel ändern sich nicht.