MCP-Server für Coding-Agenten
funktionalLass Claude Code, Cursor, VS Code und Windsurf deine gespeicherten Verbindungen über MCP nur lesend nutzen, ohne dass Passwörter geteilt werden.
SQLLY kann als lokaler Model Context Protocol (MCP)-Server, sodass Coding-Agents wie Claude Code, Cursor, VS Code, Windsurf und Claude Desktop die Verbindungen verwenden können, die du bereits in SQLly gespeichert hast. Der Agent kann Verbindungen auflisten, Tabellen durchsuchen, Spaltendefinitionen lesen, eine Schemaübersicht abrufen und genau ein
SELECT mit begrenzten Zeilen. Er sieht niemals ein Passwort, und Produktionsverbindungen werden immer abgelehnt.
- Lokal und nur über stdio. Der Agent startet
sqlly-cli mcpauf deinem Rechner und spricht über Standard-Ein- und -Ausgabe mit ihm. Nichts lauscht an einem Netzwerkport. - Standardmäßig nur lesbar. Schreibvorgänge sind nur möglich, wenn du sie erlaubst, und selbst dann öffnet sich jeder einzelne in SQLly, damit du ihn bestätigst.
- Passwörter bleiben in deinem Schlüsselbund. Der Server meldet sich selbst bei deinen Datenbanken an; der Agent erhält nur Verbindungsnamen, Schema-Text und Ergebniszeilen.
Einrichtung
- Öffnen Einstellungen › KI › MCP und finden SQLLY als MCP-Server.
- Wähle das Globales Limit: Nur-Lesen (Standard), oder Lesen/Schreiben mit Bestätigung. Wähle aus, welche gespeicherten Verbindungen freigegeben werden.
- Drücke die Kopieren-Schaltfläche für deinen Agenten: Für Claude Code kopieren, Für Cursor kopieren, Für VS Code kopieren, Für Windsurf kopieren oder Für Claude Desktop kopieren, und füge den Ausschnitt dort ein, wo dieser Agent seine MCP-Server ablegt.
- Den Agenten bitten, deine SQLly-Verbindungen aufzulisten.
Die Ausschnitte benennen den vollständigen Pfad zu sqlly-cli, das Befehlszeilen-Tool, das in der App steckt. SQLly sucht zuerst neben der App, dann auf deinem
PATH; wenn es keines von beiden findet, sagt das Snippet schlicht sqlly-cli. Die Formen sind:
# Claude Code claude mcp add --transport stdio sqlly -- /path/to/sqlly-cli mcp // Cursor, Windsurf and Claude Desktop { "mcpServers": { "sqlly": { "command": "/path/to/sqlly-cli", "args": ["mcp"] } } } // VS Code (.vscode/mcp.json) { "servers": { "sqlly": { "type": "stdio", "command": "/path/to/sqlly-cli", "args": ["mcp"] } } }
Derselbe Bereich enthält auch eine Liste von extern MCP-Servern. Diese Liste geht in die andere Richtung: Server, mit denen SQLly sich verbindet, damit sein eigener KI-Assistent weiß, welche Tools sie anbieten. Du brauchst sie nicht, damit ein Agent SQLly nutzen kann.
Was der Agent tun kann
| Werkzeug | Was es bewirkt |
|---|---|
list_connections | Listet die freigegebenen Verbindungen mit Engine, Server, Datenbank und Umgebung auf und sagt dir, ob es sich jeweils um eine Produktions- oder eine Nur-Lese-Verbindung handelt. |
list_tables | Listet die Tabellen in der Datenbank einer Verbindung auf. |
describe_table | Spalten, Typen und Nullbarkeit für eine Tabelle. |
get_schema_context | Eine Schema-Zusammenfassung, die auf ein Token-Budget zugeschnitten ist. |
run_readonly_query | Führt ein SELECT und gibt bis zum Zeilenlimit zurück. Alles andere wird abgelehnt, ohne ausgeführt zu werden. |
open_in_app | Öffnet einen Abfrage-Tab in SQLly, optional mit ausgefülltem SQL. Nichts wird ausgeführt. |
propose_write | Schlägt eine datenändernde Anweisung zur Bestätigung in SQLly vor (nur wenn Schreibvorgänge erlaubt sind). |
get_proposal_status | Ob ein Vorschlag aussteht, geöffnet, ausgeführt, abgelehnt oder abgelaufen ist. |
Nur-Lese- und Lese-/Schreibmodi
das Globales Limit setzt das Maximum, das jede Verbindung erlaubt. Jede Verbindung kann dann niedriger eingestellt werden: Globale Einstellungen erben, Gesperrt (überhaupt nicht sichtbar), Schreibgeschützt, oder Lesen/Schreiben mit Bestätigung. Eine Verbindung erreicht niemals mehr als die globale Obergrenze.
Schreibgeschützt wird von der Datenbank durchgesetzt, nicht nur durch die Anweisungsprüfung von SQLly. Bei PostgreSQL, MySQL und MariaDB läuft jede Abfrage in einer schreibgeschützten Transaktion, die immer zurückgesetzt wird; SQLite führt sie im Modus query_only aus; SQL Server, der keine schreibgeschützte Transaktion hat, führt sie innerhalb einer zurückgesetzten Transaktion plus einer Anweisungsprüfung aus. Bei ClickHouse gilt nur das SELECT-only-Prüfung greift, und Redis-Befehle werden gegen eine schreibgeschützte Liste geprüft.
Wenn Schreibvorgänge erlaubt sind, propose_write führt selbst nie etwas aus. SQLly öffnet die Anweisung in einem neuen Abfragetab, zeigt eine geschätzte Zeilenanzahl und, wo die Engine es unterstützt, eine einzeilige Planzusammenfassung, und führt sie nur über den üblichen Bestätigungsdialog aus, sobald du zustimmst.
Grenzen
- Zeilen und Zellen. Maximal 100 Zeilen pro Abfrage (Standard und Obergrenze), und lange Zellwerte werden standardmäßig auf 200 Zeichen gekürzt (bis zu 2000).
- Ratenlimits. Standardmäßig 60 Abfragen, 5 Schreibvorgänge und 2 Schemaänderungen pro Minute, einstellbar bis zu 600, 60 und 20.
- Leerlauf-Timeout. Der Server stoppt standardmäßig nach 15 Minuten ohne Anfrage (einstellbar von 30 Sekunden bis zu einem Tag).
Das Aktivitätsprotokoll
SQLly protokolliert jeden Toolaufruf des Agenten und den Ausgang jedes Vorschlags in einem privaten Protokoll auf deinem Rechner. Jeder Eintrag enthält Zeit, Tool, Verbindung, Datenbank, Dauer, Zeilenanzahl und Ergebnis. Das SQL wird geschwärzt gespeichert, niemals mit den echten Werten. Drücke MCP-Aktivität öffnen in den MCP-Einstellungen, um es anzusehen, nach Tool, Ergebnis oder Verbindung zu filtern und als CSV oder JSON zu exportieren.
Mac App Store Ausgabe
Apples Sandbox verhindert, dass App-Store-Apps andere Programme starten, sodass die Mac-App-Store-Version nicht als MCP-Server für andere Apps dienen kann und auch keine lokalen (stdio-)MCP-Server starten kann. MCP-Server, die du über HTTP erreichst, funktionieren dort weiterhin. Siehe macOS und der Mac App Store.