MCP-Server für PostgreSQL

Eine Model Context Protocol (MCP)-Serverimplementierung für PostgreSQL, die eine einfache Schnittstelle zur Interaktion mit PostgreSQL-Datenbanken über MCP bietet.

Merkmale

Ausführen von SQL-Abfragen mit parametrisierten Eingaben
Ausführen von INSERT/UPDATE/DELETE-Operationen
Neue Datenbanken erstellen
Erstellen oder Aktualisieren von Tabellenschemata
Debuggen von PostgreSQL-Verbindungen
Containerisiert mit Docker für einfache Bereitstellung
Umgebungsbasierte Konfiguration

Voraussetzungen

Python 3.8+
PostgreSQL 10+
Docker (optional, für containerisierte Bereitstellung)
Docker Compose (optional, für die Entwicklung)

Installation

Docker verwenden (empfohlen)

Klonen Sie das Repository:
git clone https://github.com/asadudin/mcp-server-postgres.git cd mcp-server-postgres
Kopieren Sie die Beispielumgebungsdatei:
cp .env.example .env
Aktualisieren Sie die .env Datei mit Ihren PostgreSQL-Anmeldeinformationen:
PG_HOST=postgres PG_PORT=5432 PG_USER=postgres PG_PASSWORD=your_password PG_DATABASE=your_database HOST=0.0.0.0 PORT=8056
Starten Sie den Dienst mit Docker Compose:
docker-compose up -d

Manuelle Installation

Klonen Sie das Repository:
git clone https://github.com/asadudin/mcp-server-postgres.git cd mcp-server-postgres
Erstellen und aktivieren Sie eine virtuelle Umgebung:
python -m venv venv source venv/bin/activate # On Windows: .\venv\Scripts\activate
Installieren Sie Abhängigkeiten:
pip install -r requirements.txt
Kopieren Sie die Beispielumgebungsdatei und aktualisieren Sie sie:
cp .env.example .env # Edit .env with your configuration
Führen Sie den Server aus:
python mcp_server_postgres.py

Verwendung

Der MCP-Server stellt die folgenden Endpunkte bereit:

`sql_query`

Führen Sie eine SELECT-Abfrage aus und geben Sie die Ergebnisse als JSON zurück.

Parameter:

query : SQL-Abfragezeichenfolge
params : Optionaler JSON-String mit Abfrageparametern (Liste oder Wörterbuch)

Beispiel:

{
  "query": "SELECT * FROM users WHERE id = $1",
  "params": [1]
}

`sql_execute`

Führen Sie eine INSERT/UPDATE/DELETE-Anweisung aus.

Parameter:

query : SQL-Anweisung
params : Optionaler JSON-String mit Abfrageparametern (Liste oder Wörterbuch)

Beispiel:

{
  "query": "INSERT INTO users (name, email) VALUES ($1, $2)",
  "params": ["John Doe", "john@example.com"]
}

`create_database`

Erstellen Sie eine neue PostgreSQL-Datenbank.

Parameter:

database_name : Name der zu erstellenden Datenbank

`create_or_update_table`

Erstellen oder aktualisieren Sie ein Tabellenschema.

Parameter:

sql : CREATE TABLE- oder ALTER TABLE-SQL-Anweisung

`debug_postgres_connection`

Debuggen Sie die PostgreSQL-Verbindung.

Umgebungsvariablen

Variable	Standard	Beschreibung
PG_HOST	lokaler Host	PostgreSQL-Host
PG_PORT	5432	PostgreSQL-Port
PG_USER	Postgres	PostgreSQL-Benutzername
PG_PASSWORD		PostgreSQL-Passwort
PG_DATABASE	Postgres	Standarddatenbankname
GASTGEBER	0.0.0.0	Host, an den der MCP-Server gebunden werden soll
HAFEN	8056	Port, auf dem der MCP-Server ausgeführt wird

Entwicklung

Ausführen von Tests

# Install test dependencies
pip install -r requirements-dev.txt

# Run tests
pytest

Erstellen des Docker-Images

docker build -t mcp-server-postgres .

API-Dokumentation

Eine ausführliche API-Dokumentation finden Sie in der OpenAPI-Spezifikation .

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

Danksagung

FastMCP - Das MCP-Server-Framework
asyncpg – PostgreSQL-Client für Python
FastAPI – Modernes, schnelles Web-Framework zum Erstellen von APIs

This server cannot be installed

security - not tested

license - not found

quality - not tested

Eine Model Context Protocol-Serverimplementierung, die eine einfache Schnittstelle zur Interaktion mit PostgreSQL-Datenbanken bietet und SQL-Abfragen, Datenbankoperationen und Schemaverwaltung über MCP ermöglicht.

Related MCP Servers

Enhanced PostgreSQL MCP Server
GarethCott
-
security
F
license
-
quality
A Model Context Protocol server providing both read and write access to PostgreSQL databases, enabling LLMs to query data, modify records, and manage database schemas.
Last updated -
4
JavaScript
PostgreSQL MCP Server
HenkDz
-
security
A
license
-
quality
A Model Context Protocol server that enables powerful PostgreSQL database management capabilities including analysis, schema management, data migration, and monitoring through natural language interactions.
Last updated -
355
46
TypeScript
AGPL 3.0
Database MCP Server
georgi-terziyski
-
security
-
license
-
quality
A Model Context Protocol server that provides tools for connecting to and interacting with various database systems (SQLite, PostgreSQL, MySQL/MariaDB, SQL Server) through a unified interface.
Last updated -
Python
MCP PostgreSQL Server
a21071
-
security
F
license
-
quality
A Model Context Protocol server that enables performing PostgreSQL database operations (create, read, update, delete) on User and Post entities through MCP tools.
Last updated -
TypeScript

View all related MCP servers

MCP Server for PostgreSQL