hs-sql-agent

Firebird · MCP

Firebird-MCP-Server für KI-Agenten.

Verbinden Sie KI-Clients über die MCP-Oberfläche von hs-sql-agent, den typisierten SQL-Compiler, Zugriffsrichtlinien, Safe DML und die Audit-Grenze sicher mit Firebird.

Technische Dokumentation lesen GitHub
01

Eine kontrollierte MCP-Oberfläche

Stellen Sie Firebird bereit, ohne dem Modell eine unrestricted database connection zu geben.

02

Dialektbewusster Compiler

Firebird-spezifische SQL-Semantik bleibt innerhalb einer expliziten Source-/Target-Capability-Grenze.

03

Richtlinie vor Ausführung

Datenbank-Scope, Tabellenrichtlinien, Tool-Einschränkungen, Rate Limits, Safe DML und Audit greifen vor dem Commit.

Firebird bleibt hinter einer Compiler-Grenze

hs-sql-agent vertraut einer vom Modell generierten Firebird-Anweisung nicht allein deshalb, weil der Provider sie ausführen könnte. SQL durchläuft zuerst die typisierte Validierungs- und Capability-Pipeline.

Provider-Support bedeutet, dass die Runtime verbinden, Metadaten lesen, unterstützte Anweisungen kompilieren und unter Richtlinien ausführen kann. Er bedeutet nicht, dass jede herstellerspezifische Syntax automatisch akzeptiert wird.

Metadaten verwenden, bevor das Schema geraten wird

MCP-Clients können vor dem Erzeugen von Firebird-SQL Schemas, Tabellen und Spalten über die integrierten Metadata Tools lesen. Das reduziert blindes Raten und hält Discovery innerhalb desselben authentifizierten Datenbank-Scope.

  • get_schemas
  • get_tables
  • get_columns
  • execute_query_sql
  • execute_dml_sql

Ablehnen, wenn die Semantik nicht nachgewiesen ist

Für Firebird gilt dieselbe Regel wie für alle anderen Provider: Nicht unterstützte Syntax oder nicht nachgewiesene cross-provider semantics werden an der passenden Validierungs- oder Capability-Grenze abgelehnt, statt stillschweigend in SQL mit anderem Verhalten umgeschrieben zu werden.

Warum sollten Firebird-Zugangsdaten nicht direkt an die KI gehen?

Wenn der MCP-Client Datenbankzugangsdaten direkt besitzt, entspricht die Berechtigungsgrenze des Modells im Wesentlichen allem, was dieses Firebird-Konto ausführen darf. hs-sql-agent hält die echte Verbindung auf dem Server und prüft vor der Ausführung SQL-Compiler, MCP-Schlüsselumfang, Tabellenrichtlinien, erlaubte Tools und Laufzeitgrenzen.

So bleibt Roh-SQL für unterstützte Anweisungen verfügbar, ohne dass die Fähigkeit, SQL zu erzeugen, zu uneingeschränkter Datenbankautorität wird.

  • Roh-SQL bleibt für unterstützte Anweisungen verfügbar
  • Datenbankzugangsdaten bleiben hinter der Servergrenze
  • nicht beweisbare Semantik wird vor der Ausführung abgelehnt
  • DML kann eine ausdrückliche menschliche Freigabe erfordern