Grain SQL
Überblick
Beschreibung vom Entwickler (englisches Original)
Run SQL queries and inspect database schemas through safe, visible MCP tools.
Was du damit machen kannst
Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.
- Verbindung: Läuft auf deinem Computer
- Transport: stdio
- Kategorie: Datenbanken & Datensätze
- Das musst du eintragen: GRAIN_CONNECTIONS
Installation
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
2/2 Prüfungen bestanden · Läuft auf deinem Computer
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Grain SQL (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Bei Grain SQL registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Kann Geld kosten.
Einstellungsdatei der Claude-Desktop-App öffnen
SettingsDeveloperEdit Config
Diese Einstellungen einfügen und speichern
{ "mcpServers": { "grain": { "command": "npx", "args": [ "-y", "grain-tools" ], "env": { "GRAIN_CONNECTIONS": "your-value", "GRAIN_MCP_SAFE_MODE": "your-value", "GRAIN_MAX_ROWS": "your-value" } } } }Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Claude beenden und neu öffnen
Ausprobieren
Nutze Grain SQL und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Grain SQL nutzt, oder ein Werkzeug von Grain SQL in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann Grain SQL noch nicht verbinden
Grain SQL läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
Das kannst du stattdessen tun
A · Eine App nutzen, die Grain SQL verbinden kann
- Du brauchst einen Schlüssel von Grain SQL (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
- Du brauchst einen Schlüssel von Grain SQL (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
- Du brauchst einen Schlüssel von Grain SQL (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
- Du brauchst einen Schlüssel von Grain SQL (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
B · Andere in Datenbanken & Datensätze, die mit ChatGPT funktionieren
Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden
- Supabase✓ ChatGPT
- Appwrite MCP✓ ChatGPT
- Pg Aiguide✓ ChatGPT
Klappt mit Claude Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Grain SQL (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Bei Grain SQL registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Kann Geld kosten.
Terminal öffnen
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
Diesen Befehl einfügen und Enter drücken
claude mcp add grain --env GRAIN_CONNECTIONS=your-value --env GRAIN_MCP_SAFE_MODE=your-value --env GRAIN_MAX_ROWS=your-value -- npx -y grain-toolsErsetze „your-value“ vor dem Enter durch deinen Schlüssel
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
/mcp in Claude Code eingeben
Grain SQL sollte in der Liste als verbunden erscheinen
Ausprobieren
Nutze Grain SQL und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Grain SQL nutzt, oder ein Werkzeug von Grain SQL in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Grain SQL (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Bei Grain SQL registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Kann Geld kosten.
Schlüssel eintragen
In den Einstellungen von Grain SQL ist GRAIN_CONNECTIONS, GRAIN_MCP_SAFE_MODE, GRAIN_MAX_ROWS leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
KI-Chat in Cursor im Agent-Modus öffnen
Ausprobieren
Nutze Grain SQL und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Grain SQL nutzt, oder ein Werkzeug von Grain SQL in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Grain SQL (auf der Seite des Anbieters registrieren, kann kosten) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Node.js installieren
Nur einmal; gilt für alle Server, die Node.js brauchen
Bei Grain SQL registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Kann Geld kosten.
Mit diesem Button VS Code öffnen
VS Code fragt nach einer Bestätigung; klicke Install
Schlüssel eintragen
In den Einstellungen von Grain SQL ist GRAIN_CONNECTIONS, GRAIN_MCP_SAFE_MODE, GRAIN_MAX_ROWS leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
KI-Chat in VS Code im Agent-Modus öffnen
Ausprobieren
Nutze Grain SQL und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Grain SQL nutzt, oder ein Werkzeug von Grain SQL in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Für Entwickler: Terminal-Befehle und JSON-Einstellungen
Auf deinem Computer installiert
Claude Code
claude mcp add grain --env GRAIN_CONNECTIONS=your-value --env GRAIN_MCP_SAFE_MODE=your-value --env GRAIN_MAX_ROWS=your-value -- npx -y grain-toolsClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"grain": {
"command": "npx",
"args": [
"-y",
"grain-tools"
],
"env": {
"GRAIN_CONNECTIONS": "your-value",
"GRAIN_MCP_SAFE_MODE": "your-value",
"GRAIN_MAX_ROWS": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"grain": {
"command": "npx",
"args": [
"-y",
"grain-tools"
],
"env": {
"GRAIN_CONNECTIONS": "your-value",
"GRAIN_MCP_SAFE_MODE": "your-value",
"GRAIN_MAX_ROWS": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"grain": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"grain-tools"
],
"env": {
"GRAIN_CONNECTIONS": "your-value",
"GRAIN_MCP_SAFE_MODE": "your-value",
"GRAIN_MAX_ROWS": "your-value"
}
}
}
}Werte, die du selbst einträgst
GRAIN_CONNECTIONSgeheim envJSON array of Grain connection profiles for headless use.GRAIN_MCP_SAFE_MODEenvSet to false to allow mutating SQL. Defaults to true.GRAIN_MAX_ROWSenvMaximum rows returned by query tools. Defaults to 10000.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Auf einen Blick
- Downloads pro Wochei
- 1.070/Wo.
- Verbindung
- Läuft auf deinem Computer
- Transport
- stdio
- Neueste Versioni
- 0.10.49
- Kategoriei
- Datenbanken & Datensätze
- In der Registry veröffentlichti
- 5. Nov. 2026
- Code zuletzt geänderti
- 5. Nov. 2026
- Entwickler
- pattrnlabs
- Pakete
npm: grain-tools- Website
- grain.tools
- Registry-Status
- Aktiv
Welche Apps ihn nutzen können
Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Was er kann
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Basischecksi
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 11. Nov. 2026
- ✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto pattrnlabs bestätigt, dem das Repo gehört
- ✓ Bestanden
Wird noch gepflegt
Code zuletzt geändert: vor 6 Tagen
- … Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
- – Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
- – Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
- … Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Diskussion
Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Nutzerbewertungen
Noch keine Bewertungen
Im Vergleich mit anderen in Datenbanken & Datensätzei
- Mehr Sterne als 86 % der anderen 1163 Server in dieser Kategorie
- Neuer in der Registry veröffentlicht als 87 % der anderen 1163 Server in dieser Kategorie
- Basischecks gleich gut wie oder besser als bei 100 % der anderen 1163 Server in dieser Kategorie
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Häufige Fragen
Ist Grain SQL sicher?
Er hat 2 von 2 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Welche Schlüssel oder Codes braucht er?
Das musst du eintragen: GRAIN_CONNECTIONS
Läuft er auf meinem Computer oder in der Cloud?
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Wird er noch gepflegt?
Das GitHub-Repo wurde zuletzt vor 6 Tagen geändert, und die neueste Version (0.10.49) kam vor 6 Tagen in die Registry.
Welche Apps können ihn nutzen?
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.
Was kann ich stattdessen nutzen?
In derselben Kategorie: Dbx, MCP Toolbox for Databases, MCP Toolbox for Databases
Alternativen
Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
MCP Toolbox for Databases
MCP Toolbox for Databases enables your agent to connect to your database.
MCP Toolbox for Databases
MCP Toolbox for Databases enables your agent to connect to your database.
README vom Entwickler
README öffnen
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
Grain
A fast SQL workspace for VS Code, and for the AI agents you work with.
Docs · Changelog · Report a bug · Ask a question
Run SQL from any .sql file with Ctrl+Enter and get the results in a sortable grid inside VS Code. Passwords stay in your OS keychain, and Grain has no hosted service.
Quick start
- Install Grain from the VS Code Marketplace or Open VSX (for Cursor, Windsurf, and VSCodium).
- Open a folder in VS Code. Grain adds its demo files there.
- Open the Grain panel and click Try the Demo.
- Put your cursor in any query in the file that opens and press
Ctrl+Enter(Cmd+Enteron macOS).
The demo reads two CSV files through Grain's built-in DuckDB connection, so there's nothing to set up. To query your own database, run Grain: Manage Connections, add a profile, and test it before you save.
If Grain is useful to you, a star on this repo helps other developers find it.
Use Grain from an AI agent
Grain can serve your database connections to Claude Code, Cursor, and GitHub Copilot over MCP. Agents get read-only access by default, and every query an agent runs shows up in your Grain results panel, so you can see exactly what it did.
MCP is off until you turn on grain.mcpEnabled in settings. Setup steps for each client are in the MCP docs, and example prompts are in examples/agents/.
Features
| Feature | What it does |
|---|---|
| Run from the editor | Ctrl+Enter runs the file; Run Query Under Cursor runs one statement; Run Query in New Tab keeps the previous result |
| Non-blocking queries | Queries run in a background process, so a slow query doesn't freeze VS Code |
| Connection manager | Create, test, and switch database profiles without editing JSON |
| Result grid | Sort, filter, and resize columns, see each column's SQL type, copy a selection as TSV |
| Full export | The grid shows the first 500 rows; export re-runs the query and writes every row to CSV, TSV, or JSON |
| Agent access over MCP | Claude Code, Cursor, and Copilot can query your connections; their results land in your panel |
| Remote setups | Works over WSL, dev containers, GitHub Codespaces, and Remote - SSH |
Supported databases
Relational databases
PostgreSQL
MySQL
SQL Server
SQLite
Data warehouses
Snowflake
BigQuery
Query engines & lakehouses
Trino / Presto
DuckDB
Search
Elasticsearch
Through Trino or Presto you can query your cluster's Iceberg, Delta Lake, and Hive tables. DuckDB queries local CSV and Parquet files directly.
PostgreSQL and Trino / Presto are bundled with the extension. The others load their driver on first use, and if a driver is missing, Grain tells you what to install.
Need another database? Request a connector. Requests with the most 👍 get built first.
Examples
Runnable queries for Postgres, MySQL, Elasticsearch, and DuckDB, plus agent prompts. Open any .sql file with Grain installed and press Ctrl+Enter.
Privacy
- Your SQL, results, and passwords stay on your machine. Passwords are stored in VS Code Secret Storage, backed by your OS keychain, and never in a settings file.
- Agents are read-only by default. With
grain.mcpSafeModeon (the default), agents can only runSELECT,SHOW,DESCRIBE,EXPLAIN,WITH, and metadata queries. Agents can't read stored passwords or change saved connections. - Telemetry is anonymous. Grain sends usage data that never includes SQL, results, credentials, hostnames, or schema names. Turn it off with
grain.telemetry.enabled.
FAQ
Is Grain open source?\ No. Grain is closed-source. This repo holds the issue tracker, docs, and examples.
Which databases does it support?\ The nine listed above. To ask for another one, request a connector.
Do my queries or passwords leave my machine?\ No. There's no Grain server. Queries go straight from VS Code to your database, and passwords stay in your OS keychain. See Privacy for what the anonymous telemetry does and doesn't include.
How do I connect Claude Code or Cursor?\ Turn on grain.mcpEnabled, then follow the steps for your client in the MCP docs.
Why does my database show a driver error?\ Some connectors load their driver on first use. The error message names what to install. If it's still failing after that, file a bug report with the Output panel logs (View → Output → Grain).
Getting help
- Bug: file a bug report
- Feature idea: file a feature request
- New database: request a connector
- Question: check the FAQ and docs, then ask a question
We don't have a fixed roadmap yet. What we build next depends a lot on what people ask for here, especially connector requests. See CONTRIBUTING.md for how to file a good issue.
Star History
License
Grain is closed-source. See LICENSE.