Ermöglicht KI-Clients sicheren und strukturierten Zugriff auf PostgreSQL-Datenbanken durch kontrollierte SQL-Ausführung und Schema-Suche.
Auch bekannt als arifulislamat/database-mcp, @database-mcp/postgres
- Stars
- 5
- Tools
- —
- Downloads, 30 Tage
- 738
- Neueste Version
- 0.5.0
- Letzter Commit
- 1. Nov. 2026
- Lizenz
- MIT
Was ist database-mcp-postgres MCP?
Ermöglicht KI-Clients sicheren und strukturierten Zugriff auf PostgreSQL-Datenbanken durch kontrollierte SQL-Ausführung und Schema-Suche.
Zusammenfassung generiert aus dem README des Projekts
Über database-mcp-postgres MCP server
Die Hauptfunktion dieses Servers ist die sichere und strukturierte Verbindung von KI-Clients mit PostgreSQL-Datenbanken. Er bietet eine minimale Schnittstelle, die aus zwei spezifischen Tools besteht – execute_sql und search_objects –, um sicherzustellen, dass das Context Window des Modells übersichtlich bleibt. Entwickler können dies nutzen, um einer KI das Erkunden von Schemas und das Ausführen von Queries zu ermöglichen, ohne das System mit unnötigen Daten zu überlasten.
Sicherheit ist durch Standard-Guardrails wie den Read-only-Modus, Statement-Timeouts und Zeilen-Limits fest im Design verankert. So werden Ergebnisse beispielsweise standardmäßig auf 1000 Zeilen begrenzt und Queries brechen nach 30 Sekunden ab. Verbindungsdetails und Credentials werden über Umgebungsvariablen, YAML Config-Dateien oder Command-Line-Flags verwaltet statt über Chat-Prompts, wodurch sichergestellt wird, dass sensible Informationen außerhalb der Konversation und der Logs bleiben.
Dieser Server ist in mehreren Implementierungen verfügbar, darunter TypeScript via npm, Python über PyPI und Rust via crates.io. Nutzer können die Verbindung über einen DSN oder spezifische Umgebungsvariablen wie POSTGRES_URL konfigurieren, um eine sichere Verbindung zu ihrer Datenbank herzustellen.
Was du damit machen kannst
- 1Erkunden von Datenbank-SchemasEine KI kann mithilfe des Search-Tools schrittweise Tabellen, Spalten und Foreign Keys entdecken.
- 2Ausführen kontrollierter SQL-QueriesEntwickler können einer KI erlauben, spezifische SQL-Commands auszuführen, während die Sicherheit durch integrierte Limits gewahrt bleibt.
- 3Verhindern von RessourcenerschöpfungDer Server verwaltet die Query-Performance automatisch, indem er die Anzahl der zurückgegebenen Zeilen begrenzt und Zeitlimits setzt.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du database-mcp-postgres MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügendatabase-mcp-postgres MCP in Claude Code installieren
$ claude mcp add --env 'POSTGRES_DATABASE=<POSTGRES_DATABASE>' --env 'POSTGRES_HOST=<POSTGRES_HOST>' --env 'POSTGRES_USER=<POSTGRES_USER>' --env 'POSTGRES_PASSWORD=<YOUR_POSTGRES_PASSWORD>' database-mcp-postgres -- npx -y @database-mcp/postgresdatabase-mcp-postgres MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"database-mcp-postgres": {
"command": "npx",
"args": [
"-y",
"@database-mcp/postgres"
],
"env": {
"POSTGRES_DATABASE": "<POSTGRES_DATABASE>",
"POSTGRES_HOST": "<POSTGRES_HOST>",
"POSTGRES_USER": "<POSTGRES_USER>",
"POSTGRES_PASSWORD": "<YOUR_POSTGRES_PASSWORD>"
}
}
}
}database-mcp-postgres MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"database-mcp-postgres": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@database-mcp/postgres"
],
"env": {
"POSTGRES_DATABASE": "<POSTGRES_DATABASE>",
"POSTGRES_HOST": "<POSTGRES_HOST>",
"POSTGRES_USER": "<POSTGRES_USER>",
"POSTGRES_PASSWORD": "<YOUR_POSTGRES_PASSWORD>"
}
}
}
}database-mcp-postgres MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"database-mcp-postgres","type":"stdio","command":"npx","args":["-y","@database-mcp/postgres"],"env":{"POSTGRES_DATABASE":"<POSTGRES_DATABASE>","POSTGRES_HOST":"<POSTGRES_HOST>","POSTGRES_USER":"<POSTGRES_USER>","POSTGRES_PASSWORD":"<YOUR_POSTGRES_PASSWORD>"}}'database-mcp-postgres MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"database-mcp-postgres": {
"command": "npx",
"args": [
"-y",
"@database-mcp/postgres"
],
"env": {
"POSTGRES_DATABASE": "<POSTGRES_DATABASE>",
"POSTGRES_HOST": "<POSTGRES_HOST>",
"POSTGRES_USER": "<POSTGRES_USER>",
"POSTGRES_PASSWORD": "<YOUR_POSTGRES_PASSWORD>"
}
}
}
}database-mcp-postgres MCP in Codex installieren
$ codex mcp add database-mcp-postgres --env 'POSTGRES_DATABASE=<POSTGRES_DATABASE>' --env 'POSTGRES_DATABASE=<POSTGRES_DATABASE>' --env 'POSTGRES_DATABASE=<POSTGRES_DATABASE>' --env 'POSTGRES_HOST=<POSTGRES_HOST>' --env 'POSTGRES_HOST=<POSTGRES_HOST>' --env 'POSTGRES_HOST=<POSTGRES_HOST>' --env 'POSTGRES_USER=<POSTGRES_USER>' --env 'POSTGRES_USER=<POSTGRES_USER>' --env 'POSTGRES_USER=<POSTGRES_USER>' --env 'POSTGRES_PASSWORD=<YOUR_POSTGRES_PASSWORD>' --env 'POSTGRES_PASSWORD=<YOUR_POSTGRES_PASSWORD>' --env 'POSTGRES_PASSWORD=<YOUR_POSTGRES_PASSWORD>' -- npx -y @database-mcp/postgresdatabase-mcp-postgres MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.database-mcp-postgres] command = "npx" args = ["-y", "@database-mcp/postgres"] [mcp_servers.database-mcp-postgres.env] POSTGRES_DATABASE = "<POSTGRES_DATABASE>" POSTGRES_HOST = "<POSTGRES_HOST>" POSTGRES_USER = "<POSTGRES_USER>" POSTGRES_PASSWORD = "<YOUR_POSTGRES_PASSWORD>"
database-mcp-postgres MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'POSTGRES_DATABASE=<POSTGRES_DATABASE>' -e 'POSTGRES_DATABASE=<POSTGRES_DATABASE>' -e 'POSTGRES_DATABASE=<POSTGRES_DATABASE>' -e 'POSTGRES_HOST=<POSTGRES_HOST>' -e 'POSTGRES_HOST=<POSTGRES_HOST>' -e 'POSTGRES_HOST=<POSTGRES_HOST>' -e 'POSTGRES_USER=<POSTGRES_USER>' -e 'POSTGRES_USER=<POSTGRES_USER>' -e 'POSTGRES_USER=<POSTGRES_USER>' -e 'POSTGRES_PASSWORD=<YOUR_POSTGRES_PASSWORD>' -e 'POSTGRES_PASSWORD=<YOUR_POSTGRES_PASSWORD>' -e 'POSTGRES_PASSWORD=<YOUR_POSTGRES_PASSWORD>' database-mcp-postgres npx -- -y @database-mcp/postgresdatabase-mcp-postgres MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"database-mcp-postgres": {
"command": "npx",
"args": [
"-y",
"@database-mcp/postgres"
],
"env": {
"POSTGRES_DATABASE": "<POSTGRES_DATABASE>",
"POSTGRES_HOST": "<POSTGRES_HOST>",
"POSTGRES_USER": "<POSTGRES_USER>",
"POSTGRES_PASSWORD": "<YOUR_POSTGRES_PASSWORD>"
}
}
}
}Konfiguration
POSTGRES_DATABASEErforderlichDatabase name
POSTGRES_DATABASEErforderlichDatabase name
POSTGRES_DATABASEErforderlichDatabase name
POSTGRES_HOSTErforderlichDatabase host
POSTGRES_HOSTErforderlichDatabase host
POSTGRES_HOSTErforderlichDatabase host
POSTGRES_USERErforderlichDatabase user (a read-only user is recommended)
POSTGRES_USERErforderlichDatabase user (a read-only user is recommended)
POSTGRES_USERErforderlichDatabase user (a read-only user is recommended)
POSTGRES_PASSWORDSecretDatabase password (or use POSTGRES_PASSWORD_FILE)
POSTGRES_PASSWORDSecretDatabase password (or use POSTGRES_PASSWORD_FILE)
POSTGRES_PASSWORDSecretDatabase password (or use POSTGRES_PASSWORD_FILE)
| Name | Beschreibung | Typ |
|---|---|---|
| POSTGRES_DATABASE | Database name | Erforderlich |
| POSTGRES_DATABASE | Database name | Erforderlich |
| POSTGRES_DATABASE | Database name | Erforderlich |
| POSTGRES_HOST | Database host | Erforderlich |
| POSTGRES_HOST | Database host | Erforderlich |
| POSTGRES_HOST | Database host | Erforderlich |
| POSTGRES_USER | Database user (a read-only user is recommended) | Erforderlich |
| POSTGRES_USER | Database user (a read-only user is recommended) | Erforderlich |
| POSTGRES_USER | Database user (a read-only user is recommended) | Erforderlich |
| POSTGRES_PASSWORD | Database password (or use POSTGRES_PASSWORD_FILE) | Secret |
| POSTGRES_PASSWORD | Database password (or use POSTGRES_PASSWORD_FILE) | Secret |
| POSTGRES_PASSWORD | Database password (or use POSTGRES_PASSWORD_FILE) | Secret |
Automatisierte Checks
Geluften am 12. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertNicht geprüft
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehendatabase-mcp
MCP servers that give AI clients safe, structured access to SQL databases.
One installable package per database engine, in TypeScript (npm), Python
(PyPI), and Rust (crates.io). Every package exposes the same minimal
two-tool surface, execute_sql and search_objects, with guardrails on by
default: read-only mode, row caps, and statement timeouts.
Packages
| Engine | TypeScript (npm) | Python (PyPI) | Rust (crates.io) |
|---|---|---|---|
| SQLite | @database-mcp/sqlite |
database-mcp-sqlite |
database-mcp-rs-sqlite |
| libSQL | @database-mcp/libsql |
database-mcp-libsql |
database-mcp-rs-libsql |
| MySQL | @database-mcp/mysql |
database-mcp-mysql |
database-mcp-rs-mysql |
| MariaDB | @database-mcp/mariadb |
database-mcp-mariadb |
database-mcp-rs-mariadb |
| Postgres | @database-mcp/postgres |
database-mcp-postgres |
database-mcp-rs-postgres |
All three lines are published and pass the same language-agnostic conformance suite against real databases in CI, so behavior is identical regardless of language. Every engine is also listed on the MCP Registry with all three install options: npm, PyPI, and cargo.
Rust crates are named database-mcp-rs-<engine> because the plain names are
taken on crates.io; the command each one installs is still
database-mcp-<engine>. Go is planned.
Design principles
- Two tools, no more. A tiny tool surface keeps the model's context window
clean.
search_objectsprogressively discloses schema: call it with no arguments to list tables, with a table name to get columns, indexes, and foreign keys. - Safe by default. Read-only mode is enforced in two layers: a conservative SQL guard, plus a session-level read-only setting in the database itself. Rows are capped (default 1000) and statements time out (default 30s).
- Configured at launch, never via chat. Connection details come from flags, a YAML config file, or environment variables. Credentials are never accepted through a tool call.
- Secrets never appear in logs. Passwords live in non-printable secret types, DSNs are sanitized before logging, and a redaction filter guards the log boundary.
Quick start
Pick your engine's package; each README has the full config surface. SQLite via npm:
{
"mcpServers": {
"sqlite": {
"command": "npx",
"args": ["-y", "@database-mcp/sqlite", "--dsn", "/absolute/path/to/database.db"]
}
}
}
Or via PyPI: use "command": "uvx" and
"args": ["database-mcp-sqlite", "--dsn", "/absolute/path/to/database.db"].
Or as a native binary, with no Node or Python runtime: run
cargo install database-mcp-rs-sqlite, then use
"command": "database-mcp-sqlite" with the same args minus the package
name.
Flags, environment variables, and YAML config are identical across all three lines.
Networked engines take credentials from the environment (MYSQL_*,
MARIADB_*, POSTGRES_*/DATABASE_URL, LIBSQL_URL/LIBSQL_AUTH_TOKEN),
*_FILE mounted secrets, or a YAML file via --config. Never from a chat
prompt.
Contributing
See CONTRIBUTING.md. The short version: the conformance
suite is the definition of done. A change is mergeable only when
conformance/run.mjs passes against every affected server.
License
database-mcp-postgres MCP Fragen
Wie füge ich database-mcp-postgres MCP zu Claude Code hinzu?
Führe claude mcp add --env 'POSTGRES_DATABASE=<POSTGRES_DATABASE>' --env 'POSTGRES_HOST=<POSTGRES_HOST>' --env 'POSTGRES_USER=<POSTGRES_USER>' --env 'POSTGRES_PASSWORD=<YOUR_POSTGRES_PASSWORD>' database-mcp-postgres -- npx -y @database-mcp/postgres in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich database-mcp-postgres MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Wie stellt der Server die Sicherheit der Datenbank sicher?
Er nutzt eine zweistufige Read-only-Erzwingung, die aus einem konservativen SQL-Guard und einer Read-only-Einstellung auf Session-Ebene in der Datenbank besteht.
Was sind die Standardlimits für Queries?
Der Server ist standardmäßig auf ein Limit von 1000 Zeilen und einen Statement-Timeout von 30 Sekunden eingestellt.
Wie werden Datenbank-Credentials gehandhabt?
Credentials werden über Flags, Umgebungsvariablen oder YAML Config-Dateien bereitgestellt und niemals über Chat-Prompts akzeptiert.
Sind Datenbank-Passwörter in den Logs sichtbar?
Nein, Passwörter verwenden nicht druckbare Secret-Typen und DSNs werden bereinigt, um sicherzustellen, dass Secrets niemals in den Logs erscheinen.