[{"_1":2,"_307":-5,"_308":-5},"loaderData",{"_3":4,"_22":23,"_24":25,"_254":255},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"BOT","id",7058884,"membership","referenceId","01971406-43e3-74e8-b880-2f000258007a","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_81":-5,"_82":40,"_29":83,"_172":173,"_253":136},"availableLocales",[28,40,46,53,60,67,74],{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","Ein erweiterter Model Context Protocol-Server, der es LLMs ermöglicht, Datenbankschemata mit umfangreichen Metadaten zu prüfen und schreibgeschützte SQL-Abfragen mit Sicherheitsüberprüfungen auszuführen.","name","PostgreSQL Advanced MCP Server","readme","# PostgreSQL-MCP-Server mit vollem Zugriff\n\n[![Modellkontextprotokoll](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io) [![MIT-Lizenz](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\nEin leistungsstarker Model Context Protocol-Server mit **vollem Lese- und Schreibzugriff** auf PostgreSQL-Datenbanken. Im Gegensatz zum offiziellen MCP-PostgreSQL-Server mit Lesezugriff ermöglicht diese erweiterte Implementierung Large Language Models (LLMs) das Abfragen und Ändern von Datenbankinhalten mit ordnungsgemäßem Transaktionsmanagement und Sicherheitskontrollen.\n\n## Inhaltsverzeichnis\n\n* [Merkmale](#features)\n\n * [Vollständiger Lese-/Schreibzugriff](#full-read-write-access)\n * [Umfangreiche Schemainformationen](#rich-schema-information)\n * [Erweiterte Sicherheitskontrollen](#advanced-safety-controls)\n* [Werkzeuge](#tools)\n\n * [Abfrage ausführen](#execute_query)\n * [execute\\_dml\\_ddl\\_dcl\\_tcl](#execute_dml_ddl_dcl_tcl)\n * [Wartung ausführen](#execute_maintenance)\n * [Ausführen\\_Commit](#execute_commit)\n * [execute\\_rollback](#execute_rollback)\n * [list\\_tables](#list_tables)\n * [Tabelle beschreiben](#describe_table)\n* [Ressourcen](#resources)\n* [Verwendung mit Claude Desktop](#using-with-claude-desktop)\n\n * [Claude Desktop Integration](#claude-desktop-integration)\n * [Wichtig: Aus Sicherheitsgründen „Einmal zulassen“ verwenden](#important-using-allow-once-for-safety)\n* [Umgebungsvariablen](#environment-variables)\n* [Vollständigen Datenbankzugriff mit Claude verwenden](#using-full-database-access-with-claude)\n* [Sicherheitsüberlegungen](#security-considerations)\n\n * [Datenbankbenutzerberechtigungen](#database-user-permissions)\n * [Best Practices für die sichere Nutzung](#best-practices-for-safe-usage)\n* [Docker](#docker)\n* [Lizenz](#license)\n* [Vergleich mit dem offiziellen PostgreSQL MCP-Server](#comparison-with-official-postgresql-mcp-server)\n\n## 🌟 Funktionen\n\n### Vollständiger Lese-/Schreibzugriff\n\n* Sicheres Ausführen von DML-Operationen (INSERT, UPDATE, DELETE)\n* Erstellen, ändern und verwalten Sie Datenbankobjekte mit DDL\n* Transaktionsmanagement mit explizitem Commit\n* Sicherheitstimeouts und automatischer Rollback-Schutz\n\n### Umfangreiche Schemainformationen\n\n* Detaillierte Spaltenmetadaten (Datentypen, Beschreibungen, maximale Länge, Nullbarkeit)\n* Primärschlüsselidentifikation\n* Fremdschlüsselbeziehungen\n* Indexinformationen mit Typ- und Eindeutigkeitsflags\n* Schätzungen der Tabellenzeilenanzahl\n* Tabellen- und Spaltenbeschreibungen (sofern verfügbar)\n\n### Erweiterte Sicherheitskontrollen\n\n* SQL-Abfrageklassifizierung (DQL, DML, DDL, DCL, TCL)\n* Erzwungene schreibgeschützte Ausführung für sichere Abfragen\n* Alle Operationen werden in isolierten Transaktionen ausgeführt\n* Automatische Transaktions-Timeout-Überwachung\n* Konfigurierbare Sicherheitsgrenzen\n* Zweistufiger Transaktions-Commit-Prozess mit expliziter Benutzerbestätigung\n\n## 🔧 Werkzeuge\n\n* **Abfrage ausführen**\n\n * Ausführen schreibgeschützter SQL-Abfragen (SELECT-Anweisungen)\n * Eingabe: `sql` (Zeichenfolge): Die auszuführende SQL-Abfrage\n * Alle Abfragen werden innerhalb einer READ ONLY-Transaktion ausgeführt\n * Zu den Ergebnissen gehören Ausführungszeitmetriken und Feldinformationen\n\n* **execute\\_dml\\_ddl\\_dcl\\_tcl**\n\n * Führen Sie Datenänderungsvorgänge (INSERT, UPDATE, DELETE) oder Schemaänderungen (CREATE, ALTER, DROP) aus.\n * Eingabe: `sql` (Zeichenfolge): Die auszuführende SQL-Anweisung\n * Automatisch in eine Transaktion mit konfigurierbarem Timeout eingebunden\n * Gibt eine Transaktions-ID für explizites Commit zurück\n * **Wichtige Sicherheitsfunktion** : Die Konversation wird nach der Ausführung beendet, sodass der Benutzer die Ergebnisse überprüfen kann, bevor er sich für ein Commit oder Rollback entscheidet.\n\n* **Wartung ausführen**\n\n * Führen Sie Wartungsbefehle wie VACUUM, ANALYZE oder CREATE DATABASE außerhalb von Transaktionen aus\n * Eingabe: `sql` (Zeichenfolge): Die auszuführende SQL-Anweisung – muss VACUUM, ANALYZE oder CREATE DATABASE sein\n * Gibt ein Ergebnisobjekt mit Ausführungszeitmetriken zurück\n\n* **Ausführen\\_Commit**\n\n * Explizites Commit einer Transaktion anhand ihrer ID\n * Eingabe: `transaction_id` (Zeichenfolge): ID der zu bestätigenden Transaktion\n * Sichere Bereinigung nach Commit oder Rollback\n * Wendet Änderungen dauerhaft auf die Datenbank an\n\n* **execute\\_rollback**\n\n * Explizites Zurücksetzen einer Transaktion anhand ihrer ID\n * Eingabe: `transaction_id` (Zeichenfolge): ID der Transaktion, die zurückgesetzt werden soll\n * Verwirft alle Änderungen sicher und bereinigt die Ressourcen\n * Nützlich, wenn Sie Änderungen überprüfen und entscheiden, sie nicht anzuwenden\n\n* **list\\_tables**\n\n * Erhalten Sie eine umfassende Liste aller Tabellen in der Datenbank\n * Enthält Spaltenanzahl und Tabellenbeschreibungen\n * Keine Eingabeparameter erforderlich\n\n* **Tabelle beschreiben**\n\n * Erhalten Sie detaillierte Informationen zu einer bestimmten Tabellenstruktur\n * Eingabe: `table_name` (Zeichenfolge): Name der zu beschreibenden Tabelle\n * Gibt vollständige Schemainformationen zurück, einschließlich Primärschlüssel, Fremdschlüssel, Indizes und Spaltendetails\n\n## 📊 Ressourcen\n\nDer Server stellt erweiterte Schemainformationen für Datenbanktabellen bereit:\n\n* **Tabellenschemata** ( `postgres:////schema` )\n * Detaillierte JSON-Schemainformationen für jede Tabelle\n * Enthält vollständige Spaltenmetadaten, Primärschlüssel und Einschränkungen\n * Automatisch aus Datenbankmetadaten ermittelt\n\n## 🚀 Verwendung mit Claude Desktop\n\n### Claude Desktop Integration\n\nUm diesen Server mit Claude Desktop zu verwenden, folgen Sie diesen Schritten:\n\n1. Stellen Sie zunächst sicher, dass Node.js auf Ihrem System installiert ist\n\n2. Installieren Sie das Paket mit npx oder fügen Sie es Ihrem Projekt hinzu\n\n3. Konfigurieren Sie Claude Desktop, indem Sie `claude_desktop_config.json` bearbeiten (normalerweise zu finden unter `~/Library/Application Support/Claude/` unter macOS):\n\n```json\n{\n \"mcpServers\": {\n \"postgres-full\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-postgres-full-access\",\n \"postgresql://username:password@localhost:5432/database\"\n ],\n \"env\": {\n \"TRANSACTION_TIMEOUT_MS\": \"60000\",\n \"MAX_CONCURRENT_TRANSACTIONS\": \"5\",\n \"PG_STATEMENT_TIMEOUT_MS\": \"30000\"\n }\n }\n }\n}\n```\n\n4. Ersetzen Sie die Datenbankverbindungszeichenfolge durch Ihre tatsächlichen PostgreSQL-Verbindungsdetails\n5. Starten Sie Claude Desktop vollständig neu\n\n### Wichtig: Aus Sicherheitsgründen „Einmal zulassen“ verwenden\n\nWenn Claude versucht, Änderungen an Ihrer Datenbank vorzunehmen, fordert Claude Desktop Sie zur Genehmigung auf:\n\n![Dialogfeld „Einmal zulassen“](https://example.com/allow-once-dialog.png)\n\n**Überprüfen Sie die SQL-Änderungen immer sorgfältig, bevor Sie sie genehmigen!**\n\nBewährte Vorgehensweisen für die Sicherheit:\n\n* Klicken Sie bei Commit-Vorgängen immer auf „Einmal zulassen“ (nicht auf „Immer zulassen“).\n* Überprüfen Sie die Transaktions-SQL sorgfältig, bevor Sie sie genehmigen\n* Erwägen Sie die Verwendung eines Datenbankbenutzers mit eingeschränkten Berechtigungen\n* Verwenden Sie nach Möglichkeit eine Testdatenbank, wenn Sie diesen Server zum ersten Mal ausprobieren.\n\nDieser „Einmal zulassen“-Ansatz gibt Ihnen die volle Kontrolle, um unerwünschte Änderungen an Ihrer Datenbank zu verhindern, während Claude bei Bedarf weiterhin bei Datenverwaltungsaufgaben helfen kann.\n\n## ⚙️ Umgebungsvariablen\n\nSie können das Serververhalten mit Umgebungsvariablen in Ihrer Claude Desktop-Konfiguration anpassen:\n\n```json\n\"env\": {\n \"TRANSACTION_TIMEOUT_MS\": \"60000\",\n \"MAX_CONCURRENT_TRANSACTIONS\": \"5\"\n}\n```\n\nWichtige Umgebungsvariablen:\n\n* `TRANSACTION_TIMEOUT_MS` : Transaktions-Timeout in Millisekunden (Standard: 15000)\n\n * Erhöhen Sie diesen Wert, wenn Ihre Transaktionen mehr Zeit benötigen\n * Transaktionen, die diese Zeit überschreiten, werden aus Sicherheitsgründen automatisch zurückgesetzt\n\n* `MAX_CONCURRENT_TRANSACTIONS` : Maximale Anzahl gleichzeitiger Transaktionen (Standard: 10)\n\n * Verringern Sie diese Zahl für einen konservativeren Betrieb\n * Höhere Werte ermöglichen mehr gleichzeitige Schreibvorgänge\n\n* `ENABLE_TRANSACTION_MONITOR` : Transaktionsmonitor aktivieren/deaktivieren („true“ oder „false“, Standard: „true“)\n\n * Überwacht abgebrochene Transaktionen und macht diese automatisch rückgängig\n * Muss selten deaktiviert werden\n\n* `PG_STATEMENT_TIMEOUT_MS` : Timeout für die Ausführung der SQL-Abfrage in ms (Standard: 30000)\n\n * Begrenzt die Dauer der Ausführung einzelner SQL-Anweisungen\n * Wichtige Sicherheitsfunktion zur Verhinderung außer Kontrolle geratener Abfragen\n\n* `PG_MAX_CONNECTIONS` : Maximale PostgreSQL-Verbindungen (Standard: 20)\n\n * Wichtig, um innerhalb der Verbindungslimits Ihrer Datenbank zu bleiben\n\n* `MONITOR_INTERVAL_MS` : Wie oft auf feststeckende Transaktionen geprüft werden soll (Standard: 5000)\n\n * Normalerweise muss nichts angepasst werden\n\n## 🔄 Vollständigen Datenbankzugriff mit Claude verwenden\n\nDieser Server ermöglicht Claude mit Ihrer Zustimmung das Lesen und Schreiben in Ihrer PostgreSQL-Datenbank. Hier sind einige Beispiele für Konversationsabläufe:\n\n### Beispiel: Erstellen einer neuen Tabelle und Hinzufügen von Daten\n\nSie: „Ich brauche eine neue Produkttabelle mit Spalten für ID, Name, Preis und Lagerbestand.“\n\nClaude: *Analysiert Ihre Datenbank und erstellt eine Abfrage*\n\n```sql\nCREATE TABLE products (\n id SERIAL PRIMARY KEY,\n name VARCHAR(100) NOT NULL,\n price DECIMAL(10,2) NOT NULL,\n inventory INTEGER DEFAULT 0\n);\n```\n\n*Claude Desktop fordert Sie auf, diesen Vorgang zu genehmigen*\n\nSie: *Überprüfen Sie und klicken Sie auf „Einmal zulassen“.*\n\nClaude: „Ich habe die Produkttabelle erstellt. Soll ich einige Beispieldaten hinzufügen?“\n\nSie: „Ja, bitte fügen Sie 5 Beispielprodukte hinzu“\n\nClaude: *Erstellt INSERT-Anweisungen und fordert zur Genehmigung auf.* *Sie überprüfen und genehmigen mit „Einmal zulassen“.*\n\n### Beispiel: Datenanalyse mit sicheren Abfragen\n\nSie: „Welches sind meine drei preislich besten Produkte?“\n\nClaude: *Führt automatisch eine schreibgeschützte Abfrage aus* *Zeigt Ihnen die Ergebnisse*\n\n### Sicherheits-Workflow\n\nDas wichtigste Sicherheitsmerkmal ist der zweistufige Ansatz für alle Vorgänge, die Ihre Datenbank ändern:\n\n1. Claude analysiert Ihre Anfrage und bereitet SQL vor\n2. Für Nur-Lese-Operationen (SELECT) führt Claude automatisch aus\n3. Für Schreibvorgänge (INSERT, UPDATE, DELETE, CREATE usw.):\n * Claude führt das SQL in einer Transaktion aus und beendet die Konversation\n * Sie überprüfen die Ergebnisse\n * In einer neuen Konversation antworten Sie mit \"Ja\" zum Festschreiben oder mit \"Nein\" zum Zurücksetzen\n * Claude Desktop zeigt Ihnen genau, was geändert wird und fragt nach Erlaubnis\n * Klicken Sie auf „Einmal zulassen“, um den jeweiligen Vorgang zuzulassen\n * Claude führt die Operation aus und gibt Ergebnisse zurück\n\nDadurch haben Sie mehrere Möglichkeiten, Änderungen zu überprüfen, bevor sie dauerhaft in die Datenbank übernommen werden.\n\n## ⚠️ Sicherheitsüberlegungen\n\nWenn Sie Claude mit Schreibzugriff mit Ihrer Datenbank verbinden:\n\n### Datenbankbenutzerberechtigungen\n\n**WICHTIG:** Erstellen Sie einen dedizierten Datenbankbenutzer mit entsprechenden Berechtigungen:\n\n```sql\n-- Example of creating a restricted user (adjust as needed)\nCREATE USER claude_user WITH PASSWORD 'secure_password';\nGRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_user;\nGRANT INSERT, UPDATE, DELETE ON TABLE table1, table2 TO claude_user;\n-- Only grant specific permissions as needed\n```\n\n### Best Practices für die sichere Nutzung\n\n1. **Verwenden Sie immer „Einmal zulassen“,** um jeden Schreibvorgang zu überprüfen\n\n * Wählen Sie bei Datenbankänderungen niemals „Immer zulassen“ aus\n * Nehmen Sie sich Zeit, das SQL sorgfältig zu überprüfen\n\n2. Stellen Sie bei der ersten Erkundung dieses Tools **eine Verbindung zu einer Testdatenbank her**\n\n * Erwägen Sie die Verwendung einer Datenbankkopie/eines Backups für erste Tests\n\n3. **Beschränken Sie die Berechtigungen von Datenbankbenutzern** auf das Nötigste\n\n * Vermeiden Sie die Verwendung eines Superuser- oder Administratorkontos\n * Erteilen Sie nach Möglichkeit tabellenspezifische Berechtigungen\n\n4. **Führen Sie vor umfangreicher Nutzung Datenbanksicherungen durch**\n\n5. **Geben Sie niemals vertrauliche Daten weiter** , die LLMs nicht zugänglich gemacht werden sollten.\n\n6. **Überprüfen Sie alle SQL-Operationen,** bevor Sie sie genehmigen\n\n * Überprüfen Sie die Tabellennamen\n * Überprüfen Sie die Spaltennamen und Daten\n * Bestätigen Sie, dass WHERE-Klauseln angemessen sind\n * Achten Sie auf eine ordnungsgemäße Transaktionsabwicklung\n\n### Docker\n\nDer Server kann einfach in einem Docker-Container ausgeführt werden:\n\n```bash\n# Build the Docker image\ndocker build -t mcp-postgres-full-access .\n\n# Run the container\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host:5432/database\"\n```\n\nVerwenden Sie für Docker unter macOS host.docker.internal, um eine Verbindung zum Hostnetzwerk herzustellen:\n\n```bash\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host.docker.internal:5432/database\"\n```\n\n## 📄 Lizenz\n\nDieser MCP-Server ist unter der MIT-Lizenz lizenziert.\n\n## 💡 Vergleich mit dem offiziellen PostgreSQL MCP-Server\n\n| Besonderheit | Dieser Server | Offizieller MCP PostgreSQL-Server |\n| ------------------------- | --------------------- | --------------------------------- |\n| Lesezugriff | ✅ | ✅ |\n| Schreibzugriff | ✅ | ❌ |\n| Schemadetails | Erweitert | Basic |\n| Transaktionsunterstützung | Explizit mit Timeouts | Schreibgeschützt |\n| Indexinformationen | ✅ | ❌ |\n| Fremdschlüsseldetails | ✅ | ❌ |\n| Zeilenanzahlschätzungen | ✅ | ❌ |\n| Tabellenbeschreibungen | ✅ | ❌ |\n\n## Autor\n\nErstellt von Syahiid Nur Kamil ( [@syahiidkamil](https://github.com/syahiidkamil) )\n\n***\n\nCopyright © 2024 Syahiid Nur Kamil. Alle Rechte vorbehalten.","German","tag","de-DE",{"_29":41,"_33":44,"_38":45},{"_31":42,"_33":34,"_35":43},"An enhanced Model Context Protocol server that enables LLMs to inspect database schemas with rich metadata and execute read-only SQL queries with safety checks.","# PostgreSQL Full Access MCP Server\n\n[![Model Context Protocol](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io)\n[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\nA powerful Model Context Protocol server providing **full read-write access** to PostgreSQL databases. Unlike the read-only official MCP PostgreSQL server, this enhanced implementation allows Large Language Models (LLMs) to both query and modify database content with proper transaction management and safety controls.\n\n## Table of Contents\n\n- [Features](#features)\n - [Full Read-Write Access](#full-read-write-access)\n - [Rich Schema Information](#rich-schema-information)\n - [Advanced Safety Controls](#advanced-safety-controls)\n- [Tools](#tools)\n - [execute_query](#execute_query)\n - [execute_dml_ddl_dcl_tcl](#execute_dml_ddl_dcl_tcl)\n - [execute_maintenance](#execute_maintenance)\n - [execute_commit](#execute_commit)\n - [execute_rollback](#execute_rollback)\n - [list_tables](#list_tables)\n - [describe_table](#describe_table)\n- [Resources](#resources)\n- [Using with Claude Desktop](#using-with-claude-desktop)\n - [Claude Desktop Integration](#claude-desktop-integration)\n - [Important: Using \"Allow Once\" for Safety](#important-using-allow-once-for-safety)\n- [Environment Variables](#environment-variables)\n- [Using Full Database Access with Claude](#using-full-database-access-with-claude)\n- [Security Considerations](#security-considerations)\n - [Database User Permissions](#database-user-permissions)\n - [Best Practices for Safe Usage](#best-practices-for-safe-usage)\n- [Docker](#docker)\n- [License](#license)\n- [Comparison with Official PostgreSQL MCP Server](#comparison-with-official-postgresql-mcp-server)\n\n## 🌟 Features\n\n### Full Read-Write Access\n\n- Safely execute DML operations (INSERT, UPDATE, DELETE)\n- Create, alter, and manage database objects with DDL\n- Transaction management with explicit commit\n- Safety timeouts and automatic rollback protection\n\n### Rich Schema Information\n\n- Detailed column metadata (data types, descriptions, max length, nullability)\n- Primary key identification\n- Foreign key relationships\n- Index information with type and uniqueness flags\n- Table row count estimates\n- Table and column descriptions (when available)\n\n### Advanced Safety Controls\n\n- SQL query classification (DQL, DML, DDL, DCL, TCL)\n- Enforced read-only execution for safe queries\n- All operations run in isolated transactions\n- Automatic transaction timeout monitoring\n- Configurable safety limits\n- Two-step transaction commit process with explicit user confirmation\n\n## 🔧 Tools\n\n- **execute_query**\n\n - Execute read-only SQL queries (SELECT statements)\n - Input: `sql` (string): The SQL query to execute\n - All queries are executed within a READ ONLY transaction\n - Results include execution time metrics and field information\n\n- **execute_dml_ddl_dcl_tcl**\n\n - Execute data modification operations (INSERT, UPDATE, DELETE) or schema changes (CREATE, ALTER, DROP)\n - Input: `sql` (string): The SQL statement to execute\n - Automatically wrapped in a transaction with configurable timeout\n - Returns a transaction ID for explicit commit\n - **Important safety feature**: The conversation will end after execution, allowing the user to review the results before deciding to commit or rollback\n\n- **execute_maintenance**\n\n - Execute maintenance commands like VACUUM, ANALYZE, or CREATE DATABASE outside of transactions\n - Input: `sql` (string): The SQL statement to execute - must be VACUUM, ANALYZE, or CREATE DATABASE\n - Returns a result object with execution time metrics\n\n- **execute_commit**\n\n - Explicitly commit a transaction by its ID\n - Input: `transaction_id` (string): ID of the transaction to commit\n - Safely handles cleanup after commit or rollback\n - Permanently applies changes to the database\n\n- **execute_rollback**\n\n - Explicitly rollback a transaction by its ID\n - Input: `transaction_id` (string): ID of the transaction to rollback\n - Safely discards all changes and cleans up resources\n - Useful when reviewing changes and deciding not to apply them\n\n- **list_tables**\n\n - Get a comprehensive list of all tables in the database\n - Includes column count and table descriptions\n - No input parameters required\n\n- **describe_table**\n - Get detailed information about a specific table structure\n - Input: `table_name` (string): Name of the table to describe\n - Returns complete schema information including primary keys, foreign keys, indexes, and column details\n\n## 📊 Resources\n\nThe server provides enhanced schema information for database tables:\n\n- **Table Schemas** (`postgres:///

/schema`)\n - Detailed JSON schema information for each table\n - Includes complete column metadata, primary keys, and constraints\n - Automatically discovered from database metadata\n\n## 🚀 Using with Claude Desktop\n\n### Claude Desktop Integration\n\nTo use this server with Claude Desktop, follow these steps:\n\n1. First, ensure you have Node.js installed on your system\n2. Install the package using npx or add it to your project\n\n3. Configure Claude Desktop by editing `claude_desktop_config.json` (typically found at `~/Library/Application Support/Claude/` on macOS):\n\n```json\n{\n \"mcpServers\": {\n \"postgres-full\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-postgres-full-access\",\n \"postgresql://username:password@localhost:5432/database\"\n ],\n \"env\": {\n \"TRANSACTION_TIMEOUT_MS\": \"60000\",\n \"MAX_CONCURRENT_TRANSACTIONS\": \"5\",\n \"PG_STATEMENT_TIMEOUT_MS\": \"30000\"\n }\n }\n }\n}\n```\n\n4. Replace the database connection string with your actual PostgreSQL connection details\n5. Restart Claude Desktop completely\n\n### Important: Using \"Allow Once\" for Safety\n\nWhen Claude attempts to commit changes to your database, Claude Desktop will prompt you for approval:\n\n![Allow Once Dialog](https://example.com/allow-once-dialog.png)\n\n**Always review the SQL changes carefully before approving them!**\n\nBest practices for safety:\n\n- Always click \"Allow once\" (not \"Always allow\") for commit operations\n- Review the transaction SQL carefully before approving\n- Consider using a database user with limited permissions\n- Use a testing database if possible when first trying this server\n\nThis \"Allow once\" approach gives you full control to prevent unwanted changes to your database while still enabling Claude to help with data management tasks when needed.\n\n## ⚙️ Environment Variables\n\nYou can customize the server behavior with environment variables in your Claude Desktop config:\n\n```json\n\"env\": {\n \"TRANSACTION_TIMEOUT_MS\": \"60000\",\n \"MAX_CONCURRENT_TRANSACTIONS\": \"5\"\n}\n```\n\nKey environment variables:\n\n- `TRANSACTION_TIMEOUT_MS`: Transaction timeout in milliseconds (default: 15000)\n\n - Increase this if your transactions need more time\n - Transactions exceeding this time will be automatically rolled back for safety\n\n- `MAX_CONCURRENT_TRANSACTIONS`: Maximum concurrent transactions (default: 10)\n\n - Lower this number for more conservative operation\n - Higher values allow more simultaneous write operations\n\n- `ENABLE_TRANSACTION_MONITOR`: Enable/disable transaction monitor (\"true\" or \"false\", default: \"true\")\n\n - Monitors and automatically rolls back abandoned transactions\n - Rarely needs to be disabled\n\n- `PG_STATEMENT_TIMEOUT_MS`: SQL query execution timeout in ms (default: 30000)\n\n - Limits how long any single SQL statement can run\n - Important safety feature to prevent runaway queries\n\n- `PG_MAX_CONNECTIONS`: Maximum PostgreSQL connections (default: 20)\n\n - Important to stay within your database's connection limits\n\n- `MONITOR_INTERVAL_MS`: How often to check for stuck transactions (default: 5000)\n - Usually doesn't need adjustment\n\n## 🔄 Using Full Database Access with Claude\n\nThis server enables Claude to both read from and write to your PostgreSQL database with your approval. Here are some example conversation flows:\n\n### Example: Creating a New Table and Adding Data\n\nYou: \"I need a new products table with columns for id, name, price, and inventory\"\n\nClaude: _Analyzes your database and creates a query_\n\n```sql\nCREATE TABLE products (\n id SERIAL PRIMARY KEY,\n name VARCHAR(100) NOT NULL,\n price DECIMAL(10,2) NOT NULL,\n inventory INTEGER DEFAULT 0\n);\n```\n\n_Claude Desktop will prompt you to approve this operation_\n\nYou: _Review and click \"Allow once\"_\n\nClaude: \"I've created the products table. Would you like me to add some sample data?\"\n\nYou: \"Yes, please add 5 sample products\"\n\nClaude: _Creates INSERT statements and prompts for approval_\n_You review and approve with \"Allow once\"_\n\n### Example: Data Analysis with Safe Queries\n\nYou: \"What are my top 3 products by price?\"\n\nClaude: _Executes a read-only query automatically_\n_Shows you the results_\n\n### Safety Workflow\n\nThe key safety feature is the two-step approach for any operation that modifies your database:\n\n1. Claude analyzes your request and prepares SQL\n2. For read-only operations (SELECT), Claude executes automatically\n3. For write operations (INSERT, UPDATE, DELETE, CREATE, etc.):\n - Claude executes the SQL in a transaction and ends the conversation\n - You review the results\n - In a new conversation, you respond with \"Yes\" to commit or \"No\" to rollback\n - Claude Desktop shows you exactly what will be changed and asks for permission\n - You click \"Allow once\" to permit the specific operation\n - Claude executes the operation and returns results\n\nThis gives you multiple opportunities to verify changes before they're permanently applied to the database.\n\n## ⚠️ Security Considerations\n\nWhen connecting Claude to your database with write access:\n\n### Database User Permissions\n\n**IMPORTANT:** Create a dedicated database user with appropriate permissions:\n\n```sql\n-- Example of creating a restricted user (adjust as needed)\nCREATE USER claude_user WITH PASSWORD 'secure_password';\nGRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_user;\nGRANT INSERT, UPDATE, DELETE ON TABLE table1, table2 TO claude_user;\n-- Only grant specific permissions as needed\n```\n\n### Best Practices for Safe Usage\n\n1. **Always use \"Allow once\"** to review each write operation\n\n - Never select \"Always allow\" for database modifications\n - Take time to review the SQL carefully\n\n2. **Connect to a testing database** when first exploring this tool\n\n - Consider using a database copy/backup for initial testing\n\n3. **Limit database user permissions** to only what's necessary\n\n - Avoid using a superuser or admin account\n - Grant table-specific permissions when possible\n\n4. **Implement database backups** before extensive use\n\n5. **Never share sensitive data** that shouldn't be exposed to LLMs\n\n6. **Verify all SQL operations** before approving them\n - Check table names\n - Verify column names and data\n - Confirm WHERE clauses are appropriate\n - Look for proper transaction handling\n\n### Docker\n\nThe server can be easily run in a Docker container:\n\n```bash\n# Build the Docker image\ndocker build -t mcp-postgres-full-access .\n\n# Run the container\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host:5432/database\"\n```\n\nFor Docker on macOS, use host.docker.internal to connect to the host network:\n\n```bash\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host.docker.internal:5432/database\"\n```\n\n## 📄 License\n\nThis MCP server is licensed under the MIT License.\n\n## 💡 Comparison with Official PostgreSQL MCP Server\n\n| Feature | This Server | Official MCP PostgreSQL Server |\n| ------------------- | ---------------------- | ------------------------------ |\n| Read Access | ✅ | ✅ |\n| Write Access | ✅ | ❌ |\n| Schema Details | Enhanced | Basic |\n| Transaction Support | Explicit with timeouts | Read-only |\n| Index Information | ✅ | ❌ |\n| Foreign Key Details | ✅ | ❌ |\n| Row Count Estimates | ✅ | ❌ |\n| Table Descriptions | ✅ | ❌ |\n\n## Author\n\nCreated by Syahiid Nur Kamil ([@syahiidkamil](https://github.com/syahiidkamil))\n\n---\n\nCopyright © 2024 Syahiid Nur Kamil. All rights reserved.\n","English","en-US",{"_29":47,"_33":51,"_38":52},{"_31":48,"_33":49,"_35":50},"Un servidor de protocolo de contexto de modelo mejorado que permite a los LLM inspeccionar esquemas de bases de datos con metadatos enriquecidos y ejecutar consultas SQL de solo lectura con controles de seguridad.","Servidor MCP avanzado de PostgreSQL","# Servidor MCP de acceso completo de PostgreSQL\n\n[![Protocolo de contexto modelo](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io) [![Licencia MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\nUn potente servidor de Protocolo de Contexto de Modelo (MPP) que proporciona **acceso completo de lectura y escritura** a bases de datos PostgreSQL. A diferencia del servidor MCP oficial de PostgreSQL de solo lectura, esta implementación mejorada permite a los Modelos de Lenguaje Grandes (LLM) consultar y modificar el contenido de la base de datos con una gestión de transacciones y controles de seguridad adecuados.\n\n## Tabla de contenido\n\n* [Características](#features)\n\n * [Acceso completo de lectura y escritura](#full-read-write-access)\n * [Información de esquema enriquecida](#rich-schema-information)\n * [Controles de seguridad avanzados](#advanced-safety-controls)\n* [Herramientas](#tools)\n\n * [ejecutar\\_consulta](#execute_query)\n * [ejecutar\\_dml\\_ddl\\_dcl\\_tcl](#execute_dml_ddl_dcl_tcl)\n * [ejecutar\\_confirmación](#execute_commit)\n * [ejecutar\\_rollback](#execute_rollback)\n * [listas\\_de\\_tablas](#list_tables)\n * [describe\\_tabla](#describe_table)\n* [Recursos](#resources)\n* [Uso con Claude Desktop](#using-with-claude-desktop)\n\n * [Integración de escritorio de Claude](#claude-desktop-integration)\n * [Importante: usar \"Permitir una vez\" por seguridad](#important-using-allow-once-for-safety)\n* [Variables de entorno](#environment-variables)\n* [Uso del acceso completo a la base de datos con Claude](#using-full-database-access-with-claude)\n* [Consideraciones de seguridad](#security-considerations)\n\n * [Permisos de usuario de la base de datos](#database-user-permissions)\n * [Mejores prácticas para un uso seguro](#best-practices-for-safe-usage)\n* [Estibador](#docker)\n* [Licencia](#license)\n* [Comparación con el servidor MCP oficial de PostgreSQL](#comparison-with-official-postgresql-mcp-server)\n\n## 🌟 Características\n\n### Acceso completo de lectura y escritura\n\n* Ejecutar de forma segura operaciones DML (INSERTAR, ACTUALIZAR, ELIMINAR)\n* Crear, modificar y administrar objetos de base de datos con DDL\n* Gestión de transacciones con confirmación explícita\n* Tiempos de espera de seguridad y protección de reversión automática\n\n### Información de esquema enriquecida\n\n* Metadatos de columna detallados (tipos de datos, descripciones, longitud máxima, nulabilidad)\n* Identificación de clave principal\n* Relaciones de clave externa\n* Información de índice con indicadores de tipo y unicidad\n* Estimaciones del recuento de filas de la tabla\n* Descripciones de tablas y columnas (cuando estén disponibles)\n\n### Controles de seguridad avanzados\n\n* Clasificación de consultas SQL (DQL, DML, DDL, DCL, TCL)\n* Ejecución de solo lectura forzada para consultas seguras\n* Todas las operaciones se ejecutan en transacciones aisladas\n* Monitoreo automático del tiempo de espera de las transacciones\n* Límites de seguridad configurables\n* Proceso de confirmación de transacción de dos pasos con confirmación explícita del usuario\n\n## 🔧 Herramientas\n\n* **ejecutar\\_consulta**\n\n * Ejecutar consultas SQL de solo lectura (instrucciones SELECT)\n * Entrada: `sql` (cadena): La consulta SQL a ejecutar\n * Todas las consultas se ejecutan dentro de una transacción de SOLO LECTURA\n * Los resultados incluyen métricas de tiempo de ejecución e información de campo.\n\n* **ejecutar\\_dml\\_ddl\\_dcl\\_tcl**\n\n * Ejecutar operaciones de modificación de datos (INSERTAR, ACTUALIZAR, ELIMINAR) o cambios de esquema (CREAR, ALTERAR, ELIMINAR)\n * Entrada: `sql` (cadena): La declaración SQL a ejecutar\n * Envuelto automáticamente en una transacción con tiempo de espera configurable\n * Devuelve un ID de transacción para confirmación explícita\n * **Característica de seguridad importante** : la conversación finalizará después de la ejecución, lo que permitirá al usuario revisar los resultados antes de decidir confirmar o revertir.\n\n* **ejecutar\\_confirmación**\n\n * Confirmar explícitamente una transacción por su ID\n * Entrada: `transaction_id` (cadena): ID de la transacción a confirmar\n * Maneja de forma segura la limpieza después de confirmar o revertir\n * Aplica permanentemente los cambios a la base de datos\n\n* **ejecutar\\_rollback**\n\n * Revertir explícitamente una transacción por su ID\n * Entrada: `transaction_id` (cadena): ID de la transacción a revertir\n * Descarta de forma segura todos los cambios y limpia los recursos\n * Útil para revisar cambios y decidir no aplicarlos.\n\n* **listas\\_de\\_tablas**\n\n * Obtenga una lista completa de todas las tablas de la base de datos\n * Incluye recuento de columnas y descripciones de tablas.\n * No se requieren parámetros de entrada\n\n* **describe\\_tabla**\n\n * Obtenga información detallada sobre una estructura de tabla específica\n * Entrada: `table_name` (cadena): Nombre de la tabla a describir\n * Devuelve información completa del esquema, incluidas claves principales, claves externas, índices y detalles de columnas.\n\n## 📊 Recursos\n\nEl servidor proporciona información de esquema mejorada para las tablas de base de datos:\n\n* **Esquemas de tabla** ( `postgres:///

/schema` )\n * Información detallada del esquema JSON para cada tabla\n * Incluye metadatos de columna completos, claves principales y restricciones.\n * Descubierto automáticamente a partir de metadatos de la base de datos\n\n## 🚀 Uso con Claude Desktop\n\n### Integración de escritorio de Claude\n\nPara utilizar este servidor con Claude Desktop, siga estos pasos:\n\n1. Primero, asegúrese de tener Node.js instalado en su sistema\n\n2. Instala el paquete usando npx o agrégalo a tu proyecto\n\n3. Configure Claude Desktop editando `claude_desktop_config.json` (normalmente se encuentra en `~/Library/Application Support/Claude/` en macOS):\n\n```json\n{\n \"mcpServers\": {\n \"postgres-full\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-postgres-full-access\",\n \"postgresql://username:password@localhost:5432/database\"\n ],\n \"env\": {\n \"TRANSACTION_TIMEOUT_MS\": \"60000\",\n \"MAX_CONCURRENT_TRANSACTIONS\": \"5\",\n \"PG_STATEMENT_TIMEOUT_MS\": \"30000\"\n }\n }\n }\n}\n```\n\n4. Reemplace la cadena de conexión de la base de datos con los detalles reales de su conexión PostgreSQL\n5. Reiniciar Claude Desktop por completo\n\n### Importante: usar \"Permitir una vez\" por seguridad\n\nCuando Claude intente realizar cambios en su base de datos, Claude Desktop le solicitará su aprobación:\n\n![Diálogo Permitir una vez](https://example.com/allow-once-dialog.png)\n\n**¡Siempre revise cuidadosamente los cambios de SQL antes de aprobarlos!**\n\nMejores prácticas de seguridad:\n\n* Haga clic siempre en \"Permitir una vez\" (no \"Permitir siempre\") para las operaciones de confirmación\n* Revise la transacción SQL cuidadosamente antes de aprobarla\n* Considere utilizar un usuario de base de datos con permisos limitados\n* Utilice una base de datos de prueba si es posible cuando pruebe este servidor por primera vez\n\nEste enfoque de \"Permitir una vez\" le brinda control total para evitar cambios no deseados en su base de datos y, al mismo tiempo, permite que Claude lo ayude con las tareas de administración de datos cuando sea necesario.\n\n## ⚙️ Variables de entorno\n\nPuede personalizar el comportamiento del servidor con variables de entorno en su configuración de Claude Desktop:\n\n```json\n\"env\": {\n \"TRANSACTION_TIMEOUT_MS\": \"60000\",\n \"MAX_CONCURRENT_TRANSACTIONS\": \"5\"\n}\n```\n\nVariables ambientales clave:\n\n* `TRANSACTION_TIMEOUT_MS` : Tiempo de espera de la transacción en milisegundos (valor predeterminado: 15000)\n\n * Aumente esto si sus transacciones necesitan más tiempo\n * Las transacciones que excedan este tiempo se revertirán automáticamente por seguridad.\n\n* `MAX_CONCURRENT_TRANSACTIONS` : Máximo de transacciones simultáneas (predeterminado: 10)\n\n * Reduzca este número para un funcionamiento más conservador.\n * Los valores más altos permiten más operaciones de escritura simultáneas\n\n* `ENABLE_TRANSACTION_MONITOR` : Habilitar o deshabilitar el monitor de transacciones (\"verdadero\" o \"falso\", predeterminado: \"verdadero\")\n\n * Monitorea y revierte automáticamente las transacciones abandonadas\n * Rara vez necesita ser deshabilitado\n\n* `PG_STATEMENT_TIMEOUT_MS` : Tiempo de espera de ejecución de la consulta SQL en ms (valor predeterminado: 30000)\n\n * Limita el tiempo durante el cual se puede ejecutar una sola declaración SQL\n * Característica de seguridad importante para evitar consultas descontroladas\n\n* `PG_MAX_CONNECTIONS` : Máximo de conexiones PostgreSQL (predeterminado: 20)\n\n * Es importante mantenerse dentro de los límites de conexión de su base de datos\n\n* `MONITOR_INTERVAL_MS` : Con qué frecuencia verificar transacciones bloqueadas (valor predeterminado: 5000)\n\n * Generalmente no necesita ajuste\n\n## 🔄 Cómo usar el acceso completo a la base de datos con Claude\n\nEste servidor permite a Claude leer y escribir en su base de datos PostgreSQL con su aprobación. A continuación, se muestran algunos ejemplos de flujos de conversación:\n\n### Ejemplo: crear una nueva tabla y agregar datos\n\nTú: \"Necesito una nueva tabla de productos con columnas para id, nombre, precio e inventario\"\n\nClaude: *Analiza tu base de datos y crea una consulta.*\n\n```sql\nCREATE TABLE products (\n id SERIAL PRIMARY KEY,\n name VARCHAR(100) NOT NULL,\n price DECIMAL(10,2) NOT NULL,\n inventory INTEGER DEFAULT 0\n);\n```\n\n*Claude Desktop le solicitará que apruebe esta operación*\n\nTú: *Revisa y haz clic en \"Permitir una vez\"*\n\nClaude: \"He creado la tabla de productos. ¿Quieres que añada algunos datos de muestra?\"\n\nTú: \"Sí, por favor, añade 5 productos de muestra\"\n\nClaude: *Crea declaraciones INSERT y solicita aprobación.* *Usted revisa y aprueba con \"Permitir una vez\".*\n\n### Ejemplo: Análisis de datos con consultas seguras\n\nTú: \"¿Cuáles son mis 3 productos favoritos por precio?\"\n\nClaude: *ejecuta una consulta de solo lectura automáticamente.* *Te muestra los resultados.*\n\n### Flujo de trabajo de seguridad\n\nLa característica de seguridad clave es el enfoque de dos pasos para cualquier operación que modifique su base de datos:\n\n1. Claude analiza su solicitud y prepara SQL\n2. Para operaciones de solo lectura (SELECT), Claude se ejecuta automáticamente\n3. Para operaciones de escritura (INSERTAR, ACTUALIZAR, ELIMINAR, CREAR, etc.):\n * Claude ejecuta el SQL en una transacción y finaliza la conversación.\n * Revisa los resultados\n * En una nueva conversación, responde con \"Sí\" para confirmar o \"No\" para revertir.\n * Claude Desktop te muestra exactamente qué se cambiará y te pide permiso\n * Haga clic en \"Permitir una vez\" para permitir la operación específica\n * Claude ejecuta la operación y devuelve resultados.\n\nEsto le brinda múltiples oportunidades para verificar los cambios antes de que se apliquen permanentemente a la base de datos.\n\n## ⚠️ Consideraciones de seguridad\n\nAl conectar a Claude a su base de datos con acceso de escritura:\n\n### Permisos de usuario de la base de datos\n\n**IMPORTANTE:** Cree un usuario de base de datos dedicado con los permisos adecuados:\n\n```sql\n-- Example of creating a restricted user (adjust as needed)\nCREATE USER claude_user WITH PASSWORD 'secure_password';\nGRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_user;\nGRANT INSERT, UPDATE, DELETE ON TABLE table1, table2 TO claude_user;\n-- Only grant specific permissions as needed\n```\n\n### Mejores prácticas para un uso seguro\n\n1. **Utilice siempre \"Permitir una vez\"** para revisar cada operación de escritura\n\n * Nunca seleccione \"Permitir siempre\" para modificaciones de la base de datos\n * Tómese el tiempo para revisar el SQL cuidadosamente\n\n2. **Conéctese a una base de datos de prueba** cuando explore esta herramienta por primera vez\n\n * Considere usar una copia/copia de seguridad de la base de datos para las pruebas iniciales\n\n3. **Limite los permisos de usuario de la base de datos** únicamente a lo necesario\n\n * Evite utilizar una cuenta de superusuario o administrador\n * Otorgar permisos específicos para tablas cuando sea posible\n\n4. **Implementar copias de seguridad de la base de datos** antes de un uso extensivo\n\n5. **Nunca comparta datos confidenciales** que no deberían estar expuestos a los LLM\n\n6. **Verificar todas las operaciones SQL** antes de aprobarlas\n\n * Comprobar los nombres de las tablas\n * Verificar los nombres de las columnas y los datos\n * Confirmar que las cláusulas WHERE sean apropiadas\n * Busque un manejo adecuado de las transacciones\n\n### Estibador\n\nEl servidor se puede ejecutar fácilmente en un contenedor Docker:\n\n```bash\n# Build the Docker image\ndocker build -t mcp-postgres-full-access .\n\n# Run the container\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host:5432/database\"\n```\n\nPara Docker en macOS, use host.docker.internal para conectarse a la red del host:\n\n```bash\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host.docker.internal:5432/database\"\n```\n\n## 📄 Licencia\n\nEste servidor MCP tiene licencia MIT.\n\n## 💡 Comparación con el servidor MCP oficial de PostgreSQL\n\n| Característica | Este servidor | Servidor PostgreSQL oficial de MCP |\n| ---------------------------------- | ------------------------------- | ---------------------------------- |\n| Acceso de lectura | ✅ | ✅ |\n| Acceso de escritura | ✅ | ❌ |\n| Detalles del esquema | Mejorado | Básico |\n| Soporte de transacciones | Explícito con tiempos de espera | Sólo lectura |\n| Información del índice | ✅ | ❌ |\n| Detalles de la clave externa | ✅ | ❌ |\n| Estimaciones del recuento de filas | ✅ | ❌ |\n| Descripciones de las tablas | ✅ | ❌ |\n\n## Autor\n\nCreado por Syahiid Nur Kamil ( [@syahiidkamil](https://github.com/syahiidkamil) )\n\n***\n\nCopyright © 2024 Syahiid Nur Kamil. Todos los derechos reservados.","Spanish","es-ES",{"_29":54,"_33":58,"_38":59},{"_31":55,"_33":56,"_35":57},"強化されたモデルコンテキストプロトコルサーバーにより、LLM は豊富なメタデータを使用してデータベーススキーマを検査し、安全性チェック付きの読み取り専用 SQL クエリを実行できるようになります。","PostgreSQL アドバンスド MCP サーバー","# PostgreSQL フルアクセス MCP サーバー\n\n[![モデルコンテキストプロトコル](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io) [![MITライセンス](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\nPostgreSQLデータベースへの**完全な読み書きアクセスを**提供する強力なモデルコンテキストプロトコル（MCP）サーバーです。読み取り専用の公式MCP PostgreSQLサーバーとは異なり、この強化された実装により、大規模言語モデル（LLM）は適切なトランザクション管理と安全制御により、データベースコンテンツのクエリと変更の両方を実行できます。\n\n## 目次\n\n* [特徴](#features)\n\n * [完全な読み取り/書き込みアクセス](#full-read-write-access)\n * [豊富なスキーマ情報](#rich-schema-information)\n * [高度な安全制御](#advanced-safety-controls)\n* [ツール](#tools)\n\n * [クエリ実行](#execute_query)\n * [実行\\_dml\\_ddl\\_dcl\\_tcl](#execute_dml_ddl_dcl_tcl)\n * [実行コミット](#execute_commit)\n * [実行ロールバック](#execute_rollback)\n * [リストテーブル](#list_tables)\n * [テーブルの説明](#describe_table)\n* [リソース](#resources)\n* [Claude Desktopでの使用](#using-with-claude-desktop)\n\n * [クロードデスクトップ統合](#claude-desktop-integration)\n * [重要: 安全のために「一度だけ許可」を使用する](#important-using-allow-once-for-safety)\n* [環境変数](#environment-variables)\n* [Claudeによるフルデータベースアクセスの使用](#using-full-database-access-with-claude)\n* [セキュリティに関する考慮事項](#security-considerations)\n\n * [データベースユーザー権限](#database-user-permissions)\n * [安全な使用のためのベストプラクティス](#best-practices-for-safe-usage)\n* [ドッカー](#docker)\n* [ライセンス](#license)\n* [公式PostgreSQL MCPサーバとの比較](#comparison-with-official-postgresql-mcp-server)\n\n## 🌟 特徴\n\n### 完全な読み取り/書き込みアクセス\n\n* DML操作（INSERT、UPDATE、DELETE）を安全に実行する\n* DDL を使用してデータベースオブジェクトを作成、変更、管理する\n* 明示的なコミットによるトランザクション管理\n* 安全タイムアウトと自動ロールバック保護\n\n### 豊富なスキーマ情報\n\n* 詳細な列メタデータ（データ型、説明、最大長、NULL 値可能性）\n* 主キーの識別\n* 外部キー関係\n* タイプと一意性フラグを含むインデックス情報\n* 表の行数の推定\n* 表と列の説明（利用可能な場合）\n\n### 高度な安全制御\n\n* SQL クエリ分類 (DQL、DML、DDL、DCL、TCL)\n* 安全なクエリのための読み取り専用実行の強制\n* すべての操作は独立したトランザクションで実行される\n* 自動トランザクションタイムアウト監視\n* 設定可能な安全制限\n* 明示的なユーザー確認を伴う2段階のトランザクションコミットプロセス\n\n## 🔧 ツール\n\n* **クエリ実行**\n\n * 読み取り専用SQLクエリ（SELECT文）を実行する\n * 入力: `sql` (文字列): 実行するSQLクエリ\n * すべてのクエリは読み取り専用トランザクション内で実行されます\n * 結果には実行時間のメトリックとフィールド情報が含まれます\n\n* **実行\\_dml\\_ddl\\_dcl\\_tcl**\n\n * データ変更操作（INSERT、UPDATE、DELETE）またはスキーマ変更（CREATE、ALTER、DROP）を実行する\n * 入力: `sql` (文字列): 実行するSQL文\n * タイムアウトを設定できるトランザクションに自動的にラップされます\n * 明示的なコミットのトランザクションIDを返します\n * **重要な安全機能**: 実行後に会話は終了し、ユーザーはコミットまたはロールバックを決定する前に結果を確認できます。\n\n* **実行コミット**\n\n * IDでトランザクションを明示的にコミットする\n * 入力: `transaction_id` (文字列): コミットするトランザクションのID\n * コミットまたはロールバック後のクリーンアップを安全に処理します\n * データベースへの変更を永続的に適用します\n\n* **実行ロールバック**\n\n * IDでトランザクションを明示的にロールバックする\n * 入力: `transaction_id` (文字列): ロールバックするトランザクションのID\n * すべての変更を安全に破棄し、リソースをクリーンアップします\n * 変更を確認し、適用しないことを決定するときに役立ちます\n\n* **リストテーブル**\n\n * データベース内のすべてのテーブルの包括的なリストを取得します\n * 列数とテーブルの説明が含まれています\n * 入力パラメータは不要\n\n* **テーブルの説明**\n\n * 特定のテーブル構造に関する詳細情報を取得する\n * 入力: `table_name` (文字列): 記述するテーブルの名前\n * 主キー、外部キー、インデックス、列の詳細を含む完全なスキーマ情報を返します。\n\n## 📊 リソース\n\nサーバーは、データベーステーブルの拡張スキーマ情報を提供します。\n\n* **テーブルスキーマ**( `postgres:///

/schema` )\n * 各テーブルの詳細なJSONスキーマ情報\n * 完全な列メタデータ、主キー、制約が含まれます\n * データベースのメタデータから自動的に検出\n\n## 🚀 Claude Desktop での使用\n\n### クロードデスクトップ統合\n\nこのサーバーを Claude Desktop で使用するには、次の手順に従います。\n\n1. まず、システムにNode.jsがインストールされていることを確認してください\n\n2. npxを使用してパッケージをインストールするか、プロジェクトに追加します\n\n3. `claude_desktop_config.json` (通常、macOS では`~/Library/Application Support/Claude/`にあります) を編集して、Claude Desktop を構成します。\n\n```json\n{\n \"mcpServers\": {\n \"postgres-full\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-postgres-full-access\",\n \"postgresql://username:password@localhost:5432/database\"\n ],\n \"env\": {\n \"TRANSACTION_TIMEOUT_MS\": \"60000\",\n \"MAX_CONCURRENT_TRANSACTIONS\": \"5\",\n \"PG_STATEMENT_TIMEOUT_MS\": \"30000\"\n }\n }\n }\n}\n```\n\n4. データベース接続文字列を実際のPostgreSQL接続詳細に置き換えます。\n5. Claude Desktopを完全に再起動します\n\n### 重要: 安全のために「一度だけ許可」を使用する\n\nClaude がデータベースに変更をコミットしようとすると、Claude Desktop は承認を求めます。\n\n![一度だけ許可するダイアログ](https://example.com/allow-once-dialog.png)\n\n**承認する前に、必ず SQL の変更を慎重に確認してください。**\n\n安全のためのベストプラクティス:\n\n* コミット操作では必ず「1回許可」をクリックしてください（「常に許可」ではありません）。\n* 承認する前にトランザクションSQLを注意深く確認してください\n* 権限が制限されたデータベースユーザーの使用を検討する\n* このサーバーを初めて試すときは、可能であればテストデータベースを使用してください。\n\nこの「一度許可する」アプローチにより、データベースへの不要な変更を完全に防止しながら、必要に応じて Claude がデータ管理タスクを支援できるようになります。\n\n## ⚙️ 環境変数\n\nClaude Desktop 構成の環境変数を使用して、サーバーの動作をカスタマイズできます。\n\n```json\n\"env\": {\n \"TRANSACTION_TIMEOUT_MS\": \"60000\",\n \"MAX_CONCURRENT_TRANSACTIONS\": \"5\"\n}\n```\n\n主要な環境変数:\n\n* `TRANSACTION_TIMEOUT_MS` : トランザクションタイムアウト（ミリ秒）（デフォルト: 15000）\n\n * 取引にさらに時間が必要な場合は、この値を増やしてください\n * この時間を超過した取引は安全のため自動的にロールバックされます\n\n* `MAX_CONCURRENT_TRANSACTIONS` : 最大同時トランザクション数（デフォルト: 10）\n\n * より保守的な操作を行うにはこの数値を下げます\n * 値が大きいほど、同時書き込み操作が増える\n\n* `ENABLE_TRANSACTION_MONITOR` : トランザクションモニターの有効化/無効化 (\"true\" または \"false、デフォルト: \"true\")\n\n * 放棄されたトランザクションを監視し、自動的にロールバックします\n * 無効化する必要はほとんどありません\n\n* `PG_STATEMENT_TIMEOUT_MS` : SQLクエリ実行タイムアウト（ミリ秒）（デフォルト: 30000）\n\n * 単一のSQL文の実行時間を制限します\n * クエリの暴走を防ぐための重要な安全機能\n\n* `PG_MAX_CONNECTIONS` : PostgreSQL接続の最大数（デフォルト: 20）\n\n * データベースの接続制限内に留まることが重要\n\n* `MONITOR_INTERVAL_MS` : スタックしたトランザクションをチェックする頻度（デフォルト: 5000）\n\n * 通常は調整の必要はありません\n\n## 🔄 Claude によるフルデータベースアクセスの使用\n\nこのサーバーにより、Claude はお客様の承認を得て、PostgreSQL データベースの読み取りと書き込みの両方を実行できます。以下に会話フローの例を示します。\n\n### 例: 新しいテーブルの作成とデータの追加\n\nあなた: 「ID、名前、価格、在庫の列を持つ新しい製品テーブルが必要です」\n\nクロード:*データベースを分析してクエリを作成します*\n\n```sql\nCREATE TABLE products (\n id SERIAL PRIMARY KEY,\n name VARCHAR(100) NOT NULL,\n price DECIMAL(10,2) NOT NULL,\n inventory INTEGER DEFAULT 0\n);\n```\n\n*Claude Desktopは、この操作を承認するように要求します*\n\nあなた:*確認して「一度許可」をクリックします*\n\nクロード: 「製品テーブルを作成しました。サンプルデータを追加しましょうか?」\n\nあなた：「はい、サンプル商品を5つ追加してください」\n\nクロード: *INSERT ステートメントを作成し、承認を求めます。* *「一度許可」で確認して承認します。*\n\n### 例: 安全なクエリによるデータ分析\n\nあなた: 「価格順に上位 3 つの製品は何ですか?」\n\nクロード:*読み取り専用クエリを自動的に実行し、* *結果を表示します*\n\n### 安全ワークフロー\n\n重要な安全機能は、データベースを変更するすべての操作に対して 2 段階のアプローチを採用していることです。\n\n1. クロードはリクエストを分析し、SQLを準備します\n2. 読み取り専用操作（SELECT）の場合、Claudeは自動的に実行します。\n3. 書き込み操作 (INSERT、UPDATE、DELETE、CREATE など) の場合:\n * クロードはトランザクション内でSQLを実行し、会話を終了します。\n * 結果を確認する\n * 新しい会話では、コミットするには「はい」、ロールバックするには「いいえ」と応答します。\n * Claude Desktopは変更される内容を正確に表示し、許可を求めます\n * 特定の操作を許可するには、「一度許可」をクリックします\n * クロードは操作を実行し、結果を返します\n\nこれにより、変更がデータベースに永続的に適用される前に、変更を検証する機会が複数回得られます。\n\n## ⚠️ セキュリティに関する考慮事項\n\n書き込みアクセス権を使用して Claude をデータベースに接続する場合:\n\n### データベースユーザー権限\n\n\\*\\*重要:\\*\\*適切な権限を持つ専用のデータベースユーザーを作成します。\n\n```sql\n-- Example of creating a restricted user (adjust as needed)\nCREATE USER claude_user WITH PASSWORD 'secure_password';\nGRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_user;\nGRANT INSERT, UPDATE, DELETE ON TABLE table1, table2 TO claude_user;\n-- Only grant specific permissions as needed\n```\n\n### 安全な使用のためのベストプラクティス\n\n1. 各書き込み操作を確認するには、**常に「1回許可」を使用してください。**\n\n * データベースの変更に対して「常に許可」を選択しないでください\n * 時間をかけてSQLを注意深く確認してください\n\n2. このツールを初めて使用するときは\\*\\*、テストデータベースに接続し��ください\\*\\*\n\n * 初期テストにはデータベースのコピー/バックアップの使用を検討してください\n\n3. **データベースユーザーの権限を必要なものだけに制限する**\n\n * スーパーユーザーまたは管理者アカウントの使用を避ける\n * 可能な場合はテーブル固有の権限を付与する\n\n4. 広範囲に使用する前に**データベースのバックアップを実施する**\n\n5. LLMに公開すべきでない**機密データを決して共有し**ないでください\n\n6. 承認する前に**すべてのSQL操作を検証する**\n\n * テーブル名を確認する\n * 列名とデータを検証する\n * WHERE句が適切であることを確認する\n * 適切な取引処理を探す\n\n### ドッカー\n\nサーバーは Docker コンテナ内で簡単に実行できます。\n\n```bash\n# Build the Docker image\ndocker build -t mcp-postgres-full-access .\n\n# Run the container\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host:5432/database\"\n```\n\nmacOS 上の Docker の場合、host.docker.internal を使用してホストネットワークに接続します。\n\n```bash\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host.docker.internal:5432/database\"\n```\n\n## 📄 ライセンス\n\nこの MCP サーバーは MIT ライセンスに基づいてライセンスされます。\n\n## 💡 公式PostgreSQL MCPサーバーとの比較\n\n| 特徴 | このサーバー | 公式MCP PostgreSQLサーバー |\n| ------------ | ------------- | -------------------- |\n| 読み取りアクセス | ✅ | ✅ |\n| 書き込みアクセス | ✅ | ❌ |\n| スキーマの詳細 | 強化された | 基本 |\n| トランザクションサポート | タイムアウト付きの明示的な | 読み取り専用 |\n| インデックス情報 | ✅ | ❌ |\n| 外部キーの詳細 | ✅ | ❌ |\n| 行数の見積もり | ✅ | ❌ |\n| 表の説明 | ✅ | ❌ |\n\n## 著者\n\n作成者: Syahiid Nur Kamil ( [@syahiidkamal](https://github.com/syahiidkamil) )\n\n***\n\n著作権 © 2024 Syahiid Nur Kamil. All rights reserved.","Japanese","ja-JP",{"_29":61,"_33":65,"_38":66},{"_31":62,"_33":63,"_35":64},"LLM이 풍부한 메타데이터를 통해 데이터베이스 스키마를 검사하고 안전 검사를 통해 읽기 전용 SQL 쿼리를 실행할 수 있도록 하는 향상된 모델 컨텍스트 프로토콜 서버입니다.","PostgreSQL 고급 MCP 서버","# PostgreSQL 전체 액세스 MCP 서버\n\n[![모델 컨텍스트 프로토콜](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io) [![MIT 라이센스](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\nPostgreSQL 데이터베이스에 대한 **완전한 읽기-쓰기 권한을** 제공하는 강력한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 읽기 전용 공식 MCP PostgreSQL 서버와 달리, 이 향상된 구현을 통해 대용량 언어 모델(LLM)은 적절한 트랜잭션 관리 및 보안 제어를 통해 데이터베이스 콘텐츠를 쿼리하고 수정할 수 있습니다.\n\n## 목차\n\n* [특징](#features)\n\n * [전체 읽기-쓰기 액세스](#full-read-write-access)\n * [풍부한 스키마 정보](#rich-schema-information)\n * [고급 안전 제어](#advanced-safety-controls)\n* [도구](#tools)\n\n * [실행\\_쿼리](#execute_query)\n * [실행\\_dml\\_ddl\\_dcl\\_tcl](#execute_dml_ddl_dcl_tcl)\n * [실행\\_커밋](#execute_commit)\n * [실행\\_롤백](#execute_rollback)\n * [리스트\\_테이블](#list_tables)\n * [설명\\_테이블](#describe_table)\n* [자원](#resources)\n* [Claude Desktop과 함께 사용](#using-with-claude-desktop)\n\n * [Claude 데스크톱 통합](#claude-desktop-integration)\n * [중요: 안전을 위해 \"한 번 허용\" 사용](#important-using-allow-once-for-safety)\n* [환경 변수](#environment-variables)\n* [Claude를 사용하여 전체 데이터베이스 액세스 사용](#using-full-database-access-with-claude)\n* [보안 고려 사항](#security-considerations)\n\n * [데이터베이스 사용자 권한](#database-user-permissions)\n * [안전한 사용을 위한 모범 사례](#best-practices-for-safe-usage)\n* [도커](#docker)\n* [특허](#license)\n* [공식 PostgreSQL MCP 서버와의 비교](#comparison-with-official-postgresql-mcp-server)\n\n## 🌟 특징\n\n### 전체 읽기-쓰기 액세스\n\n* DML 작업(INSERT, UPDATE, DELETE)을 안전하게 실행합니다.\n* DDL을 사용하여 데이터베이스 객체를 생성, 변경 및 관리합니다.\n* 명시적 커밋을 통한 트랜잭션 관리\n* 안전 시간 초과 및 자동 롤백 보호\n\n### 풍부한 스키마 정보\n\n* 자세한 열 메타데이터(데이터 유형, 설명, 최대 길이, Null 허용 여부)\n* 기본 키 식별\n* 외래 키 관계\n* 유형 및 고유성 플래그가 포함된 인덱스 정보\n* 테이블 행 개수 추정\n* 테이블 및 열 설명(사용 가능한 경우)\n\n### 고급 안전 제어\n\n* SQL 쿼리 분류(DQL, DML, DDL, DCL, TCL)\n* 안전한 쿼리에 대한 강제 읽기 전용 실행\n* 모든 작업은 격리된 트랜잭션으로 실행됩니다.\n* 자동 거래 시간 초과 모니터링\n* 구성 가능한 안전 한계\n* 명시적 사용자 확인을 통한 2단계 트랜잭션 커밋 프로세스\n\n## 🔧 도구\n\n* **실행\\_쿼리**\n\n * 읽기 전용 SQL 쿼리(SELECT 문) 실행\n * 입력: `sql` (문자열): 실행할 SQL 쿼리\n * 모든 쿼리는 READ ONLY 트랜잭션 내에서 실행됩니다.\n * 결과에는 실행 시간 측정 항목과 필드 정보가 포함됩니다.\n\n* **실행\\_dml\\_ddl\\_dcl\\_tcl**\n\n * 데이터 수정 작업(INSERT, UPDATE, DELETE) 또는 스키마 변경(CREATE, ALTER, DROP)을 실행합니다.\n * 입력: `sql` (문자열): 실행할 SQL 문\n * 구성 가능한 시간 초과로 트랜잭션에 자동으로 래핑됨\n * 명시적 커밋에 대한 트랜잭션 ID를 반환합니다.\n * **중요한 보안 기능** : 대화는 실행 후 종료되므로 사용자는 커밋 또는 롤백을 결정하기 전에 결과를 검토할 수 있습니다.\n\n* **실행\\_커밋**\n\n * ID로 트랜잭션을 명시적으로 커밋합니다.\n * 입력: `transaction_id` (문자열): 커밋할 트랜잭션의 ID\n * 커밋 또는 롤백 후 정리를 안전하게 처리합니다.\n * 데이터베이스에 변경 사항을 영구적으로 적용합니다.\n\n* **실행\\_롤백**\n\n * ID로 트랜잭션을 명시적으로 롤백합니다.\n * 입력: `transaction_id` (문자열): 롤백할 트랜잭션의 ID\n * 모든 변경 사항을 안전하게 삭제하고 리소스를 정리합니다.\n * 변경 사항을 검토하고 적용하지 않기로 결정할 때 유용합니다.\n\n* **리스트\\_테이블**\n\n * 데이터베이스의 모든 테이블에 대한 포괄적인 목록을 얻으세요\n * 열 개수와 테이블 설명이 포함됩니다.\n * 입력 매개변수가 필요하지 않습니다\n\n* **설명\\_테이블**\n\n * 특정 테이블 구조에 대한 자세한 정보를 얻으세요\n * 입력: `table_name` (문자열): 설명할 테이블의 이름\n * 기본 키, 외래 키, 인덱스 및 열 세부 정보를 포함한 전체 스키마 정보를 반환합니다.\n\n## 📊 리소스\n\n서버는 데이터베이스 테이블에 대한 향상된 스키마 정보를 제공합니다.\n\n* **테이블 스키마** ( `postgres:///

/schema` )\n * 각 테이블에 대한 자세한 JSON 스키마 정보\n * 전체 열 메타데이터, 기본 키 및 제약 조건이 포함됩니다.\n * 데이터베이스 메타데이터에서 자동으로 검색됨\n\n## 🚀 Claude Desktop과 함께 사용\n\n### Claude 데스크톱 통합\n\nClaude Desktop과 함께 이 서버를 사용하려면 다음 단계를 따르세요.\n\n1. 먼저, 시스템에 Node.js가 설치되어 있는지 확인하세요.\n\n2. npx를 사용하여 패키지를 설치하거나 프로젝트에 추가하세요.\n\n3. `claude_desktop_config.json` 편집하여 Claude Desktop을 구성합니다(macOS에서는 일반적으로 `~/Library/Application Support/Claude/` 에 있음):\n\n지엑스피1\n\n4. 데이터베이스 연결 문자열을 실제 PostgreSQL 연결 세부 정보로 바꾸세요.\n5. Claude Desktop을 완전히 다시 시작하세요\n\n### 중요: 안전을 위해 \"한 번 허용\" 사용\n\nClaude가 데이터베이스에 변경 사항을 적용하려고 하면 Claude Desktop에서 승인을 요청합니다.\n\n![한 번만 허용 대화 상자](https://example.com/allow-once-dialog.png)\n\n**SQL 변경 사항을 승인하기 전에 항상 주의 깊게 검토하세요!**\n\n안전을 위한 모범 사례:\n\n* 커밋 작업의 경우 항상 \"한 번 허용\"(항상 허용 아님)을 클릭합니다.\n* 승인하기 전에 거래 SQL을 주의 깊게 검토하세요.\n* 권한이 제한된 데이터베이스 사용자를 사용하는 것을 고려하세요\n* 가능하다면 이 서버를 처음 시도할 때 테스트 데이터베이스를 사용하세요.\n\n\"한 번만 허용\" 방식을 사용하면 필요할 때 Claude가 데이터 관리 작업을 지원하는 동시에 원치 않는 데이터베이스 변경을 방지하기 위한 완벽한 제어가 가능합니다.\n\n## ⚙️ 환경 변수\n\nClaude Desktop 구성에서 환경 변수를 사용하여 서버 동작을 사용자 지정할 수 있습니다.\n\n```json\n\"env\": {\n \"TRANSACTION_TIMEOUT_MS\": \"60000\",\n \"MAX_CONCURRENT_TRANSACTIONS\": \"5\"\n}\n```\n\n주요 환경 변수:\n\n* `TRANSACTION_TIMEOUT_MS` : 트랜잭션 시간 초과(밀리초) (기본값: 15000)\n\n * 거래에 더 많은 시간이 필요한 경우 이것을 늘리십시오.\n * 이 시간을 초과하는 거래는 안전을 위해 자동으로 롤백됩니다.\n\n* `MAX_CONCURRENT_TRANSACTIONS` : 최대 동시 트랜잭션 수(기본값: 10)\n\n * 보다 보수적인 작업을 위해 이 숫자를 낮추십시오.\n * 값이 높을수록 동시에 더 많은 쓰기 작업이 가능합니다.\n\n* `ENABLE_TRANSACTION_MONITOR` : 트랜잭션 모니터를 활성화/비활성화합니다(\"true\" 또는 \"false\", 기본값: \"true\")\n\n * 중단된 거래를 모니터링하고 자동으로 롤백합니다.\n * 거의 비활성화할 필요가 없습니다\n\n* `PG_STATEMENT_TIMEOUT_MS` : SQL 쿼리 실행 시간 초과(ms) (기본값: 30000)\n\n * 단일 SQL 문이 실행될 수 있는 시간을 제한합니다.\n * 폭주하는 쿼리를 방지하기 위한 중요한 보안 기능\n\n* `PG_MAX_CONNECTIONS` : 최대 PostgreSQL 연결 수(기본값: 20)\n\n * 데이터베이스 연결 한도 내에 머무르는 것이 중요합니다.\n\n* `MONITOR_INTERVAL_MS` : 중단된 거래를 확인할 빈도(기본값: 5000)\n\n * 일반적으로 조정이 필요하지 않습니다\n\n## 🔄 Claude를 사용하여 전체 데이터베이스 액세스 사용\n\n이 서버를 통해 Claude는 귀하의 승인 하에 PostgreSQL 데이터베이스를 읽고 쓸 수 있습니다. 다음은 몇 가지 대화 흐름 예시입니다.\n\n### 예: 새 테이블 만들기 및 데이터 추가\n\n당신: \"ID, 이름, 가격, 재고에 대한 열이 있는 새로운 제품 테이블이 필요합니다\"\n\nClaude: *데이터베이스를 분석하고 쿼리를 생성합니다.*\n\n```sql\nCREATE TABLE products (\n id SERIAL PRIMARY KEY,\n name VARCHAR(100) NOT NULL,\n price DECIMAL(10,2) NOT NULL,\n inventory INTEGER DEFAULT 0\n);\n```\n\n*Claude Desktop에서 이 작업을 승인하라는 메시지가 표시됩니다.*\n\n귀하: *검토 후 \"한 번 허용\"을 클릭하세요.*\n\n클로드: \"제품 테이블을 만들었습니다. 샘플 데이터를 추가할까요?\"\n\n당신: \"네, 샘플 상품 5개를 추가해주세요\"\n\nClaude: *INSERT 문을 생성하고 승인을 요청합니다.* *\"한 번 허용\"을 사용하여 검토하고 승인합니다.*\n\n### 예: 안전한 쿼리를 사용한 데이터 분석\n\n당신: \"가격별로 제가 가장 좋아하는 제품 3가지는 뭐예요?\"\n\nClaude: *읽기 전용 쿼리를 자동으로 실행합니다.* *결과를 보여줍니다.*\n\n### 안전 워크플로\n\n가장 중요한 안전 기능은 데이터베이스를 수정하는 모든 작업에 대해 2단계 접근 방식을 적용한다는 것입니다.\n\n1. Claude는 귀하의 요청을 분석하고 SQL을 준비합니다.\n2. 읽기 전용 작업(SELECT)의 경우 Claude는 자동으로 실행합니다.\n3. 쓰기 작업(INSERT, UPDATE, DELETE, CREATE 등)의 경우:\n * Claude는 트랜잭션에서 SQL을 실행하고 대화를 종료합니다.\n * 결과를 검토하세요\n * 새로운 대화에서 \"예\"로 응답하면 커밋하고 \"아니요\"로 응답하면 롤백합니다.\n * Claude Desktop은 변경되는 내용을 정확히 보여주고 권한을 요청합니다.\n * 특정 작업을 허용하려면 \"한 번 허용\"을 클릭합니다.\n * Claude는 작업을 실행하고 결과를 반환합니다.\n\n이렇게 하면 변경 사항이 데이터베이스에 영구적으로 적용되기 전에 변경 사항을 확인할 수 있는 여러 가지 기회가 제공됩니다.\n\n## ⚠️ 보안 고려 사항\n\nClaude를 쓰기 액세스 권한으로 데이터베이스에 연결하는 경우:\n\n### 데이터베이스 사용자 권한\n\n**중요:** 적절한 권한이 있는 전담 데이터베이스 사용자를 만드세요.\n\n```sql\n-- Example of creating a restricted user (adjust as needed)\nCREATE USER claude_user WITH PASSWORD 'secure_password';\nGRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_user;\nGRANT INSERT, UPDATE, DELETE ON TABLE table1, table2 TO claude_user;\n-- Only grant specific permissions as needed\n```\n\n### 안전한 사용을 위한 모범 사례\n\n1. **항상 \"한 번 허용\"을 사용하여** 각 쓰기 작업을 검토하세요.\n\n * 데이터베이스 수정에 대해 \"항상 허용\"을 선택하지 마십시오.\n * SQL을 주의 깊게 검토할 시간을 가지세요\n\n2. 이 도구를 처음 탐색할 때 **테스트 데이터베이스에 연결하세요.**\n\n * 초기 테스트를 위해 데이터베이스 복사본/백업을 사용하는 것을 고려하세요\n\n3. **데이터베이스 사용자 권한을 필요한 것으로만 제한합니다.**\n\n * 슈퍼유저나 관리자 계정 사용을 피하세요\n * 가능한 경우 테이블별 권한 부여\n\n4. 광범위하게 사용하기 전에 **데이터베이스 백업을 구현하세요**\n\n5. LLM에 노출되어서는 안 되는 **민감한 데이터는 절대 공유하지 마세요.**\n\n6. 승인하기 전에 **모든 SQL 작업을 확인하세요** .\n\n * 테이블 이름 확인\n * 열 이름과 데이터 확인\n * WHERE 절이 적절한지 확인하세요\n * 적절한 거래 처리를 찾으세요\n\n### 도커\n\n서버는 Docker 컨테이너에서 쉽게 실행할 수 있습니다.\n\n```bash\n# Build the Docker image\ndocker build -t mcp-postgres-full-access .\n\n# Run the container\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host:5432/database\"\n```\n\nmacOS의 Docker의 경우 host.docker.internal을 사용하여 호스트 네트워크에 연결합니다.\n\n```bash\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host.docker.internal:5432/database\"\n```\n\n## 📄 라이센스\n\n이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여되었습니다.\n\n## 💡 공식 PostgreSQL MCP 서버와의 비교\n\n| 특징 | 이 서버 | 공식 MCP PostgreSQL 서버 |\n| ---------- | ------------- | -------------------- |\n| 읽기 액세스 | ✅ | ✅ |\n| 쓰기 액세스 | ✅ | ❌ |\n| 스키마 세부 정보 | 강화된 | 기초적인 |\n| 거래 지원 | 시간 초과가 있는 명시적 | 읽기 전용 |\n| 인덱스 정보 | ✅ | ❌ |\n| 외래 키 세부 정보 | ✅ | ❌ |\n| 행 개수 추정치 | ✅ | ❌ |\n| 표 설명 | ✅ | ❌ |\n\n## 작가\n\n작성자: Syahiid Nur Kamil( [@syahiidkamil](https://github.com/syahiidkamil) )\n\n***\n\n저작권 © 2024 샤히드 누르 카밀. 모든 권리 보유.","Korean","ko-KR",{"_29":68,"_33":72,"_38":73},{"_31":69,"_33":70,"_35":71},"Усовершенствованный сервер Model Context Protocol, позволяющий LLM проверять схемы баз данных с подробными метаданными и выполнять SQL-запросы только для чтения с проверками безопасности.","Расширенный сервер MCP PostgreSQL","# PostgreSQL Полный доступ MCP-сервер\n\n[![Модель контекстного протокола](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io) [![Лицензия Массачусетского технологического института](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\nМощный сервер Model Context Protocol, обеспечивающий **полный доступ на чтение и запись** к базам данных PostgreSQL. В отличие от официального сервера MCP PostgreSQL, доступного только для чтения, эта улучшенная реализация позволяет моделям больших языков (LLM) как запрашивать, так и изменять содержимое базы данных с надлежащим управлением транзакциями и контролем безопасности.\n\n## Оглавление\n\n* [Функции](#features)\n\n * [Полный доступ для чтения и записи](#full-read-write-access)\n * [Богатая информация о схеме](#rich-schema-information)\n * [Расширенные средства безопасности](#advanced-safety-controls)\n* [Инструменты](#tools)\n\n * [выполнить\\_запрос](#execute_query)\n * [выполнить\\_dml\\_ddl\\_dcl\\_tcl](#execute_dml_ddl_dcl_tcl)\n * [выполнить\\_обслуживание](#execute_maintenance)\n * [выполнить\\_коммит](#execute_commit)\n * [выполнить\\_откат](#execute_rollback)\n * [список\\_таблиц](#list_tables)\n * [описать\\_таблицу](#describe_table)\n* [Ресурсы](#resources)\n* [Использование с Claude Desktop](#using-with-claude-desktop)\n\n * [Интеграция рабочего стола Клода](#claude-desktop-integration)\n * [Важно: используйте «Разрешить один раз» в целях безопасности](#important-using-allow-once-for-safety)\n* [Переменные среды](#environment-variables)\n* [Использование полного доступа к базе данных с помощью Клода](#using-full-database-access-with-claude)\n* [Соображения безопасности](#security-considerations)\n\n * [Разрешения пользователя базы данных](#database-user-permissions)\n * [Лучшие практики для безопасного использования](#best-practices-for-safe-usage)\n* [Докер](#docker)\n* [Лицензия](#license)\n* [Сравнение с официальным сервером PostgreSQL MCP](#comparison-with-official-postgresql-mcp-server)\n\n## 🌟 Особенности\n\n### Полный доступ для чтения и записи\n\n* Безопасное выполнение операций DML (INSERT, UPDATE, DELETE)\n* Создание, изменение и управление объектами базы данных с помощью DDL\n* Управление транзакциями с явным подтверждением\n* Защитные тайм-ауты и автоматическая защита от отката\n\n### Богатая информация о схеме\n\n* Подробные метаданные столбцов (типы данных, описания, максимальная длина, допустимость значений NULL)\n* Первичная идентификация ключа\n* Отношения внешнего ключа\n* Индексная информация с флагами типа и уникальности\n* Оценки количества строк таблицы\n* Описания таблиц и столбцов (если доступны)\n\n### Расширенные средства безопасности\n\n* Классификация SQL-запросов (DQL, DML, DDL, DCL, TCL)\n* Принудительное выполнение только для чтения для безопасных запросов\n* Все операции выполняются в виде изолированных транзакций.\n* Автоматический мониторинг тайм-аута транзакции\n* Настраиваемые пределы безопасности\n* Двухэтапный процесс подтверждения транзакции с явным подтверждением пользователя\n\n## 🔧 Инструменты\n\n* **выполнить\\_запрос**\n\n * Выполнение SQL-запросов только для чтения (операторы SELECT)\n * Ввод: `sql` (строка): SQL-запрос для выполнения.\n * Все запросы выполняются в рамках транзакции ТОЛЬКО ДЛЯ ЧТЕНИЯ\n * Результаты включают показатели времени выполнения и информацию о полях.\n\n* **выполнить\\_dml\\_ddl\\_dcl\\_tcl**\n\n * Выполнение операций по изменению данных (INSERT, UPDATE, DELETE) или изменений схемы (CREATE, ALTER, DROP)\n * Ввод: `sql` (строка): SQL-оператор для выполнения.\n * Автоматически упаковано в транзакцию с настраиваемым тайм-аутом\n * Возвращает идентификатор транзакции для явного подтверждения\n * **Важная функция безопасности** : диалог будет завершен после выполнения, что позволит пользователю просмотреть результаты, прежде чем принять решение о фиксации или откате.\n\n* **выполнить\\_обслуживание**\n\n * Выполнение команд обслуживания, таких как VACUUM, ANALYZE или CREATE DATABASE, вне транзакций\n * Ввод: `sql` (строка): SQL-оператор для выполнения — должен быть VACUUM, ANALYZE или CREATE DATABASE.\n * Возвращает объект результата с метриками времени выполнения.\n\n* **выполнить\\_коммит**\n\n * Явно зафиксировать транзакцию по ее идентификатору\n * Ввод: `transaction_id` (строка): идентификатор транзакции для фиксации\n * Безопасно выполняет очистку после фиксации или отката\n * Постоянно применяет изменения к базе данных\n\n* **выполнить\\_откат**\n\n * Явный откат транзакции по ее идентификатору\n * Ввод: `transaction_id` (строка): идентификатор транзакции для отката\n * Безопасно отменяет все изменения и очищает ресурсы.\n * Полезно при рассмотрении изменений и принятии решения не применять их.\n\n* **список\\_таблиц**\n\n * Получите полный список всех таблиц в базе данных\n * Включает количество столбцов и описания таблиц.\n * Входные параметры не требуются\n\n* **описать\\_таблицу**\n\n * Получите подробную информацию о конкретной структуре таблицы\n * Ввод: `table_name` (строка): Имя таблицы для описания.\n * Возвращает полную информацию о схеме, включая первичные ключи, внешние ключи, индексы и сведения о столбцах.\n\n## 📊 Ресурсы\n\nСервер предоставляет расширенную информацию о схеме для таблиц базы данных:\n\n* **Схемы таблиц** ( `postgres:///

/schema` )\n * Подробная информация о схеме JSON для каждой таблицы\n * Включает полные метаданные столбцов, первичные ключи и ограничения.\n * Автоматически обнаруживается из метаданных базы данных\n\n## 🚀 Использование с Claude Desktop\n\n### Интеграция рабочего стола Клода\n\nЧтобы использовать этот сервер с Claude Desktop, выполните следующие действия:\n\n1. Сначала убедитесь, что в вашей системе установлен Node.js.\n\n2. Установите пакет с помощью npx или добавьте его в свой проект\n\n3. Настройте Claude Desktop, отредактировав `claude_desktop_config.json` (обычно находится в `~/Library/Application Support/Claude/` на macOS):\n\n```json\n{\n \"mcpServers\": {\n \"postgres-full\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-postgres-full-access\",\n \"postgresql://username:password@localhost:5432/database\"\n ],\n \"env\": {\n \"TRANSACTION_TIMEOUT_MS\": \"60000\",\n \"MAX_CONCURRENT_TRANSACTIONS\": \"5\",\n \"PG_STATEMENT_TIMEOUT_MS\": \"30000\"\n }\n }\n }\n}\n```\n\n4. Замените строку подключения к базе данных фактическими данными подключения к PostgreSQL.\n5. Полностью перезагрузите Claude Desktop.\n\n### Важно: используйте «Разрешить один раз» для безопасности\n\nКогда Клод попытается внести изменения в вашу базу данных, Claude Desktop запросит у вас одобрение:\n\n![Разрешить один раз диалог](https://example.com/allow-once-dialog.png)\n\n**Всегда внимательно проверяйте изменения SQL перед их одобрением!**\n\nЛучшие практики обеспечения безопасности:\n\n* Всегда нажимайте «Разрешить один раз» (а не «Всегда разрешать») для операций фиксации.\n* Внимательно проверьте транзакцию SQL перед одобрением.\n* Рассмотрите возможность использования пользователя базы данных с ограниченными правами доступа.\n* При первой попытке использования этого сервера используйте, по возможности, тестовую базу данных.\n\nТакой подход «Разрешить один раз» дает вам полный контроль над предотвращением нежелательных изменений в вашей базе данных, при этом позволяя Клоду помогать с задачами управления данными, когда это необходимо.\n\n## ⚙️ Переменные среды\n\nВы можете настроить поведение сервера с помощью переменных среды в конфигурации Claude Desktop:\n\n```json\n\"env\": {\n \"TRANSACTION_TIMEOUT_MS\": \"60000\",\n \"MAX_CONCURRENT_TRANSACTIONS\": \"5\"\n}\n```\n\nКлючевые переменные среды:\n\n* `TRANSACTION_TIMEOUT_MS` : Время ожидания транзакции в миллисекундах (по умолчанию: 15000)\n\n * Увеличьте это значение, если вашим транзакциям требуется больше времени.\n * Транзакции, превышающие это время, будут автоматически откатываться в целях безопасности.\n\n* `MAX_CONCURRENT_TRANSACTIONS` : Максимальное количество одновременных транзакций (по умолчанию: 10)\n\n * Уменьшите это число для более консервативной эксплуатации.\n * Более высокие значения допускают больше одновременных операций записи.\n\n* `ENABLE_TRANSACTION_MONITOR` : включить/отключить монитор транзакций («true» или «false», по умолчанию: «true»)\n\n * Отслеживает и автоматически откатывает заброшенные транзакции\n * Редко требует отключения\n\n* `PG_STATEMENT_TIMEOUT_MS` : Время ожидания выполнения SQL-запроса в мс (по умолчанию: 30000)\n\n * Ограничивает продолжительность выполнения любого отдельного оператора SQL\n * Важная функция безопасности для предотвращения неконтролируемых запросов\n\n* `PG_MAX_CONNECTIONS` : Максимальное количество подключений PostgreSQL (по умолчанию: 20)\n\n * Важно соблюдать ограничения на количество подключений к вашей базе данных.\n\n* `MONITOR_INTERVAL_MS` : Как часто проверять наличие зависших транзакций (по умолчанию: 5000)\n\n * Обычно не требует регулировки.\n\n## 🔄 Использование полного доступа к базе данных с Клодом\n\nЭтот сервер позволяет Клоду как читать, так и писать в вашу базу данных PostgreSQL с вашего одобрения. Вот несколько примеров потоков разговоров:\n\n### Пример: создание новой таблицы и добавление данных\n\nВы: «Мне нужна новая таблица продуктов со столбцами для идентификатора, названия, цены и инвентаря»\n\nКлод: *Анализирует вашу базу данных и создает запрос*\n\n```sql\nCREATE TABLE products (\n id SERIAL PRIMARY KEY,\n name VARCHAR(100) NOT NULL,\n price DECIMAL(10,2) NOT NULL,\n inventory INTEGER DEFAULT 0\n);\n```\n\n*Claude Desktop предложит вам одобрить эту операцию.*\n\nВы: *Просмотрите и нажмите «Разрешить один раз»*\n\nКлод: «Я создал таблицу продуктов. Хотите, чтобы я добавил примеры данных?»\n\nВы: «Да, пожалуйста, добавьте 5 образцов продукции»\n\nКлод: *создает операторы INSERT и запрашивает одобрение.* *Вы просматриваете и одобряете, нажав «Разрешить один раз».*\n\n### Пример: Анализ данных с помощью безопасных запросов\n\nВы: «Какие у меня три лучших товара по цене?»\n\nКлод: *Автоматически выполняет запрос только для чтения.* *Показывает результаты.*\n\n### Безопасность рабочего процесса\n\nКлючевой функцией безопасности является двухэтапный подход к любой операции, изменяющей вашу базу данных:\n\n1. Клод анализирует ваш запрос и готовит SQL\n2. Для операций только для чтения (SELECT) Клод выполняет автоматически\n3. Для операций записи (INSERT, UPDATE, DELETE, CREATE и т. д.):\n * Клод выполняет SQL в транзакции и завершает разговор.\n * Вы просматриваете результаты\n * В новом разговоре вы отвечаете «Да», чтобы подтвердить или «Нет», чтобы откатить.\n * Claude Desktop показывает вам, что именно будет изменено, и запрашивает разрешение\n * Вы нажимаете «Разрешить один раз», чтобы разрешить определенную операцию.\n * Клод выполняет операцию и возвращает результаты.\n\nЭто дает вам множество возможностей для проверки изменений, прежде чем они будут окончательно применены к базе данных.\n\n## ⚠️ Вопросы безопасности\n\nПри подключении Клода к вашей базе данных с правом записи:\n\n### Разрешения пользователя базы данных\n\n**ВАЖНО:** Создайте отдельного пользователя базы данных с соответствующими разрешениями:\n\n```sql\n-- Example of creating a restricted user (adjust as needed)\nCREATE USER claude_user WITH PASSWORD 'secure_password';\nGRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_user;\nGRANT INSERT, UPDATE, DELETE ON TABLE table1, table2 TO claude_user;\n-- Only grant specific permissions as needed\n```\n\n### Лучшие практики для безопасного использования\n\n1. **Всегда используйте «Разрешить один раз»** для проверки каждой операции записи.\n\n * Никогда не выбирайте «Всегда разрешать» для изменений базы данных\n * Уделите время внимательному изучению SQL.\n\n2. **Подключитесь к тестовой базе данных** при первом изучении этого инструмента\n\n * Рассмотрите возможность использования копии/резервной копии базы данных для первоначального тестирования.\n\n3. **Ограничьте разрешения пользователей базы данных** только необходимыми\n\n * Избегайте использования учетной записи суперпользователя или администратора.\n * По возможности предоставляйте разрешения для конкретных таблиц.\n\n4. Перед интенсивным использованием **выполняйте резервное копирование баз данных.**\n\n5. **Никогда не передавайте конфиденциальные данные** , которые не должны быть доступны LLM\n\n6. **Проверьте все операции SQL** перед их одобрением.\n\n * Проверьте имена таблиц\n * Проверьте имена столбцов и данные\n * Подтвердите, что условия WHERE являются уместными\n * Ищите надлежащую обработку транзакций\n\n### Докер\n\nСервер можно легко запустить в контейнере Docker:\n\n```bash\n# Build the Docker image\ndocker build -t mcp-postgres-full-access .\n\n# Run the container\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host:5432/database\"\n```\n\nДля Docker на macOS используйте host.docker.internal для подключения к сети хоста:\n\n```bash\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host.docker.internal:5432/database\"\n```\n\n## 📄 Лицензия\n\nЭтот сервер MCP лицензирован в соответствии с лицензией MIT.\n\n## 💡 Сравнение с официальным сервером PostgreSQL MCP\n\n| Особенность | Этот сервер | Официальный сервер MCP PostgreSQL |\n| -------------------------- | ------------------- | --------------------------------- |\n| Доступ для чтения | ✅ | ✅ |\n| Доступ для записи | ✅ | ❌ |\n| Подробности схемы | Улучшенный | Базовый |\n| Поддержка транзакций | Явный с тайм-аутами | Только для чтения |\n| Индекс информации | ✅ | ❌ |\n| Подробности внешнего ключа | ✅ | ❌ |\n| Оценки количества строк | ✅ | ❌ |\n| Описания таблиц | ✅ | ❌ |\n\n## Автор\n\nСоздано Сяхидом Нуром Камилом ( [@syahiidkamil](https://github.com/syahiidkamil) )\n\n***\n\nАвторские права © 2024 Syahiid Nur Kamil. Все права защищены.","Russian","ru-RU",{"_29":75,"_33":79,"_38":80},{"_31":76,"_33":77,"_35":78},"增强的模型上下文协议服务器，使 LLM 能够检查具有丰富元数据的数据库模式并执行具有安全检查的只读 SQL 查询。","PostgreSQL 高级 MCP 服务器","# PostgreSQL 完全访问 MCP 服务器\n\n[![模型上下文协议](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io)[![MIT 许可证](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\n强大的模型上下文协议 (MCP) 服务器，提供对 PostgreSQL 数据库的**完全读写访问权限**。与只读的官方 MCP PostgreSQL 服务器不同，此增强版允许大型语言模型 (LLM) 查询和修改数据库内容，并具有适当的事务管理和安全控制。\n\n## 目录\n\n* [特征](#features)\n\n * [完全读写访问权限](#full-read-write-access)\n * [丰富的架构信息](#rich-schema-information)\n * [先进的安全控制](#advanced-safety-controls)\n* [工具](#tools)\n\n * [执行查询](#execute_query)\n * [执行\\_dml\\_ddl\\_dcl\\_tcl](#execute_dml_ddl_dcl_tcl)\n * [执行提交](#execute_commit)\n * [执行回滚](#execute_rollback)\n * [列表表](#list_tables)\n * [描述表](#describe_table)\n* [资源](#resources)\n* [与 Claude Desktop 一起使用](#using-with-claude-desktop)\n\n * [Claude 桌面集成](#claude-desktop-integration)\n * [重要提示：使用“允许一次”以确保安全](#important-using-allow-once-for-safety)\n* [环境变量](#environment-variables)\n* [使用 Claude 进行完全数据库访问](#using-full-database-access-with-claude)\n* [安全注意事项](#security-considerations)\n\n * [数据库用户权限](#database-user-permissions)\n * [安全使用的最佳实践](#best-practices-for-safe-usage)\n* [Docker](#docker)\n* [执照](#license)\n* [与官方 PostgreSQL MCP 服务器的比较](#comparison-with-official-postgresql-mcp-server)\n\n## 🌟 功能\n\n### 完全读写访问权限\n\n* 安全地执行 DML 操作（INSERT、UPDATE、DELETE）\n* 使用 DDL 创建、更改和管理数据库对象\n* 具有显式提交的事务管理\n* 安全超时和自动回滚保护\n\n### 丰富的架构信息\n\n* 详细列元数据（数据类型、描述、最大长度、可空性）\n* 主键标识\n* 外键关系\n* 带有类型和唯一性标志的索引信息\n* 表行数估计\n* 表格和列描述（如果有）\n\n### 先进的安全控制\n\n* SQL查询分类（DQL、DML、DDL、DCL、TCL）\n* 强制执行只读以确保安全查询\n* 所有操作都在独立事务中运行\n* 自动交易超时监控\n* 可配置的安全限制\n* 两步事务提交流程，需要用户明确确认\n\n## 🔧 工具\n\n* **执行查询**\n\n * 执行只读 SQL 查询（SELECT 语句）\n * 输入： `sql` （字符串）：要执行的 SQL 查询\n * 所有查询都在只读事务中执行\n * 结果包括执行时间指标和现场信息\n\n* **执行\\_dml\\_ddl\\_dcl\\_tcl**\n\n * 执行数据修改操作��INSERT、UPDATE、DELETE）或模式更改（CREATE、ALTER、DROP）\n * 输入： `sql` （字符串）：要执行的 SQL 语句\n * 自动包装在具有可配置超时的交易中\n * 返回显式提交的事务 ID\n * **重要的安全特性**：对话将在执行后结束，允许用户在决定提交或回滚之前查看结果\n\n* **执行提交**\n\n * 通过 ID 明确提交交易\n * 输入： `transaction_id` （字符串）：要提交的事务的ID\n * 安全地处理提交或回滚后的清理\n * 将更改永久应用于数据库\n\n* **执行回滚**\n\n * 通过事务 ID 明确回滚事务\n * 输入： `transaction_id` （字符串）：要回滚的事务的ID\n * 安全地丢弃所有更改并清理资源\n * 在审查更改并决定不应用它们时很有用\n\n* **列表表**\n\n * 获取数据库中所有表的综合列表\n * 包括列数和表格描述\n * 无需输入参数\n\n* **描述表**\n\n * 获取特定表结构的详细信息\n * 输入： `table_name` （字符串）：要描述的表的名称\n * 返回完整的架构信息，包括主键、外键、索引和列详细信息\n\n## 📊 资源\n\n服务器为数据库表提供增强的架构信息：\n\n* **表模式**（ `postgres:///

/schema` ）\n * 每个表的详细 JSON 架构信息\n * 包括完整的列元数据、主键和约束\n * 从数据库元数据中自动发现\n\n## 🚀 与 Claude Desktop 一起使用\n\n### Claude 桌面集成\n\n要将此服务器与 Claude Desktop 一起使用，请按照以下步骤操作：\n\n1. 首先，确保您的系统上安装了 Node.js\n\n2. 使用 npx 安装包或将其添加到你的项目中\n\n3. 通过编辑`claude_desktop_config.json` （通常在 macOS 上位于`~/Library/Application Support/Claude/` ）来配置 Claude Desktop：\n\n```json\n{\n \"mcpServers\": {\n \"postgres-full\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-postgres-full-access\",\n \"postgresql://username:password@localhost:5432/database\"\n ],\n \"env\": {\n \"TRANSACTION_TIMEOUT_MS\": \"60000\",\n \"MAX_CONCURRENT_TRANSACTIONS\": \"5\",\n \"PG_STATEMENT_TIMEOUT_MS\": \"30000\"\n }\n }\n }\n}\n```\n\n4. 将数据库连接字符串替换为实际的 PostgreSQL 连接详细信息\n5. 完全重启Claude Desktop\n\n### 重要提示：使用“允许一次”以确保安全\n\n当 Claude 尝试向您的数据库提交更改时，Claude Desktop 将提示您批准：\n\n![允许一次对话框](https://example.com/allow-once-dialog.png)\n\n**在批准 SQL 更改之前，请务必仔细检查！**\n\n安全最佳实践：\n\n* 对于提交操作，始终单击“允许一次”（而不是“始终允许”）\n* 批准前仔细检查交易 SQL\n* 考虑使用具有有限权限的数据库用户\n* 首次尝试此服务器时，如果可能，请使用测试数据库\n\n这种“允许一次”方法让您可以完全控制以防止对数据库进行不必要的更改，同时仍允许 Claude 在需要时帮助完成数据管理任务。\n\n## ⚙️ 环境变量\n\n您可以使用 Claude Desktop 配置中的环境变量自定义服务器行为：\n\n```json\n\"env\": {\n \"TRANSACTION_TIMEOUT_MS\": \"60000\",\n \"MAX_CONCURRENT_TRANSACTIONS\": \"5\"\n}\n```\n\n关键环境变量：\n\n* `TRANSACTION_TIMEOUT_MS` ：事务超时（以毫秒为单位）（默认值：15000）\n\n * 如果您的交易需要更多时间，请增加此值\n * 超过此时间的交易将自动回滚以确保安全\n\n* `MAX_CONCURRENT_TRANSACTIONS` ：最大并发事务数（默认值：10）\n\n * 降低此数字以实现更保守的操作\n * 值越高，允许同时进行越多的写入操作\n\n* `ENABLE_TRANSACTION_MONITOR` ：启用/禁用事务监视器（“true”或“false”，默认值：“true”）\n\n * 监控并自动回滚废弃的交易\n * 很少需要禁用\n\n* `PG_STATEMENT_TIMEOUT_MS` ：SQL 查询执行超时（毫秒）（默认值：30000）\n\n * 限制单个 SQL 语句的运行时间\n * 防止失控查询的重要安全功能\n\n* `PG_MAX_CONNECTIONS` ：最大 PostgreSQL 连接数（默认值：20）\n\n * 保持在数据库的连接限制内很重要\n\n* `MONITOR_INTERVAL_MS` ：检查卡住事务的频率（默认值：5000）\n\n * 通常不需要调整\n\n## 🔄 使用 Claude 进行完全数据库访问\n\n该服务器允许 Claude 在您的授权下读取和写入您的 PostgreSQL 数据库。以下是一些示例对话流程：\n\n### 示例：创建新表并添加数据\n\n您：“我需要一个包含 ID、名称、价格和库存等列的新产品表”\n\nClaude：*分析你的数据库并创建查询*\n\n```sql\nCREATE TABLE products (\n id SERIAL PRIMARY KEY,\n name VARCHAR(100) NOT NULL,\n price DECIMAL(10,2) NOT NULL,\n inventory INTEGER DEFAULT 0\n);\n```\n\n*Claude Desktop 将提示您批准此操作*\n\n您：*查看并点击“允许一次”*\n\n克劳德：“我已经创建了产品表。您想让我添加一些示例数据吗？”\n\n您：“是的，请添加 5 个样品”\n\nClaude：*创建 INSERT 语句并提示批准* *您使用“允许一次”进行审核和批准*\n\n### 示例：使用安全查询进行数据分析\n\n您：“按价格计算，我的前 3 种产品是什么？”\n\nClaude：*自动执行只读查询* *并显示结果*\n\n### 安全工作流程\n\n关键的安全特性是对任何修改数据库的操作采用两步方法：\n\n1. Claude 分析您的请求并准备 SQL\n2. 对于只读操作（SELECT），Claude 会自动执行\n3. 对于写入操作（INSERT、UPDATE、DELETE、CREATE 等）：\n * Claude 在事务中执行 SQL 并结束对话\n * 您查看结果\n * 在新的对话中，您回复“是”表示提交，回复“否”表示回滚\n * Claude Desktop 向您展示将要更改的内容并请求许可\n * 您点击“允许一次”即可允许特定操作\n * Claude执行操作并返回结果\n\n这为您提供了多次机会在将更改永久应用到数据库之前验证更改。\n\n## ⚠️ 安全注意事项\n\n当使用写权限将 Claude 连接到数据库时：\n\n### 数据库用户权限\n\n\\*\\*重要提示：\\*\\*创建具有适当权限的专用数据库用户：\n\n```sql\n-- Example of creating a restricted user (adjust as needed)\nCREATE USER claude_user WITH PASSWORD 'secure_password';\nGRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_user;\nGRANT INSERT, UPDATE, DELETE ON TABLE table1, table2 TO claude_user;\n-- Only grant specific permissions as needed\n```\n\n### 安全使用的最佳实践\n\n1. \\*\\*始终使用“允许一次”\\*\\*来审查每个写入操作\n\n * 切勿选择“始终允许”进行数据库修改\n * 花时间仔细检查 SQL\n\n2. 首次探索此工具时**连接到测试数据库**\n\n * 考虑使用数据库副本/备份进行初始测试\n\n3. **将数据库用户权限限制**为仅必要的权限\n\n * 避免使用超级用户或管理员帐户\n * 尽可能授予特定于表的权限\n\n4. 在广泛使用之前**实施数据库备份**\n\n5. **切勿分享不应向 LLM 公开的敏感数据**\n\n6. 在批准**所有 SQL 操作之前对其进行验证**\n\n * 检查表名\n * 验证列名和数据\n * 确认 WHERE 子句是否合适\n * 寻找适当的交易处理\n\n### Docker\n\n该服务器可以轻松地在 Docker 容器中运行：\n\n```bash\n# Build the Docker image\ndocker build -t mcp-postgres-full-access .\n\n# Run the container\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host:5432/database\"\n```\n\n对于 macOS 上的 Docker，使用 host.docker.internal 连接到主机网络：\n\n```bash\ndocker run -i --rm mcp-postgres-full-access \"postgresql://username:password@host.docker.internal:5432/database\"\n```\n\n## 📄 许可证\n\n此 MCP 服务器根据 MIT 许可证获得许可。\n\n## 💡 与官方 PostgreSQL MCP 服务器的比较\n\n| 特征 | 此服务器 | 官方 MCP PostgreSQL 服务器 |\n| ------ | ---- | --------------------- |\n| 读取访问 | ✅ | ✅ |\n| 写访问 | ✅ | ❌ |\n| 架构详细信息 | 增强型 | 基本的 |\n| 交易支持 | 显式超时 | 只读 |\n| 索引信息 | ✅ | ❌ |\n| 外键详细信息 | ✅ | ❌ |\n| 行数估计 | ✅ | ❌ |\n| 表格说明 | ✅ | ❌ |\n\n## 作者\n\n由 Syahiid Nur Kamil 创建（ [@syahiidkamil](https://github.com/syahiidkamil) ）\n\n***\n\n版权所有 © 2024 Syahiid Nur Kamil。保留所有权利。","Chinese","zh-CN","githubUser","locale",{"_84":85,"_86":87,"_13":98,"_105":42,"_106":42,"_107":108,"_111":112,"_133":-5,"_16":134,"_135":136,"_137":138,"_33":34,"_149":125,"_150":151,"_154":-5,"_155":-5,"_156":-5,"_157":158,"_163":-5,"_145":164,"_165":166,"_168":-5,"_126":169,"_170":171},"addedAt","2025-04-01T01:00:39.223223274Z","argumentsJsonSchema",{"_88":89,"_95":96,"_93":97},"properties",{"_90":91},"DATABASE_URL",{"_31":92,"_93":94},"PostgreSQL connection string (e.g., postgresql://username:password@localhost:5432/database)","type","string","required",[90],"object",[99,100,101,102,103,104],"category:databases","category:developer-tools","environment:local","hosting:hybrid","language:typescript","license_grade:f","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":43,"_109":110},"url","https://github.com/syahiidkamil/mcp-postgres-advanced","githubRepository",{"_113":114,"_115":116,"_117":118,"_119":120,"_33":121,"_122":123,"_128":129,"_130":-5,"_131":132},"defaultBranch","main","fullName","syahiidkamil/mcp-postgres-full-access","githubTreeId",117192,"language","TypeScript","mcp-postgres-full-access","owner",{"_124":125,"_126":127},"login","syahiidkamil","uid","i10TarYhcj","recentStargazers",2,"spdxLicense","stargazers",7,"glamaJson",4743,"inspectable",false,"integrations",[139],{"_140":141,"_31":147,"_126":148},"brand",{"_142":143,"_33":144,"_145":146},"logoSvgPath","M23.5594 14.7228a.5269.5269 0 0 0-.0563-.1191c-.139-.2632-.4768-.3418-1.0074-.2321-1.6533.3411-2.2935.1312-2.5256-.0191 1.342-2.0482 2.445-4.522 3.0411-6.8297.2714-1.0507.7982-3.5237.1222-4.7316a1.5641 1.5641 0 0 0-.1509-.235C21.6931.9086 19.8007.0248 17.5099.0005c-1.4947-.0158-2.7705.3461-3.1161.4794a9.449 9.449 0 0 0-.5159-.0816 8.044 8.044 0 0 0-1.3114-.1278c-1.1822-.0184-2.2038.2642-3.0498.8406-.8573-.3211-4.7888-1.645-7.2219.0788C.9359 2.1526.3086 3.8733.4302 6.3043c.0409.818.5069 3.334 1.2423 5.7436.4598 1.5065.9387 2.7019 1.4334 3.582.553.9942 1.1259 1.5933 1.7143 1.7895.4474.1491 1.1327.1441 1.8581-.7279.8012-.9635 1.5903-1.8258 1.9446-2.2069.4351.2355.9064.3625 1.39.3772a.0569.0569 0 0 0 .0004.0041 11.0312 11.0312 0 0 0-.2472.3054c-.3389.4302-.4094.5197-1.5002.7443-.3102.064-1.1344.2339-1.1464.8115-.0025.1224.0329.2309.0919.3268.2269.4231.9216.6097 1.015.6331 1.3345.3335 2.5044.092 3.3714-.6787-.017 2.231.0775 4.4174.3454 5.0874.2212.5529.7618 1.9045 2.4692 1.9043.2505 0 .5263-.0291.8296-.0941 1.7819-.3821 2.5557-1.1696 2.855-2.9059.1503-.8707.4016-2.8753.5388-4.1012.0169-.0703.0357-.1207.057-.1362.0007-.0005.0697-.0471.4272.0307a.3673.3673 0 0 0 .0443.0068l.2539.0223.0149.001c.8468.0384 1.9114-.1426 2.5312-.4308.6438-.2988 1.8057-1.0323 1.5951-1.6698zM2.371 11.8765c-.7435-2.4358-1.1779-4.8851-1.2123-5.5719-.1086-2.1714.4171-3.6829 1.5623-4.4927 1.8367-1.2986 4.8398-.5408 6.108-.13-.0032.0032-.0066.0061-.0098.0094-2.0238 2.044-1.9758 5.536-1.9708 5.7495-.0002.0823.0066.1989.0162.3593.0348.5873.0996 1.6804-.0735 2.9184-.1609 1.1504.1937 2.2764.9728 3.0892.0806.0841.1648.1631.2518.2374-.3468.3714-1.1004 1.1926-1.9025 2.1576-.5677.6825-.9597.5517-1.0886.5087-.3919-.1307-.813-.5871-1.2381-1.3223-.4796-.839-.9635-2.0317-1.4155-3.5126zm6.0072 5.0871c-.1711-.0428-.3271-.1132-.4322-.1772.0889-.0394.2374-.0902.4833-.1409 1.2833-.2641 1.4815-.4506 1.9143-1.0002.0992-.126.2116-.2687.3673-.4426a.3549.3549 0 0 0 .0737-.1298c.1708-.1513.2724-.1099.4369-.0417.156.0646.3078.26.3695.4752.0291.1016.0619.2945-.0452.4444-.9043 1.2658-2.2216 1.2494-3.1676 1.0128zm2.094-3.988-.0525.141c-.133.3566-.2567.6881-.3334 1.003-.6674-.0021-1.3168-.2872-1.8105-.8024-.6279-.6551-.9131-1.5664-.7825-2.5004.1828-1.3079.1153-2.4468.079-3.0586-.005-.0857-.0095-.1607-.0122-.2199.2957-.2621 1.6659-.9962 2.6429-.7724.4459.1022.7176.4057.8305.928.5846 2.7038.0774 3.8307-.3302 4.7363-.084.1866-.1633.3629-.2311.5454zm7.3637 4.5725c-.0169.1768-.0358.376-.0618.5959l-.146.4383a.3547.3547 0 0 0-.0182.1077c-.0059.4747-.054.6489-.115.8693-.0634.2292-.1353.4891-.1794 1.0575-.11 1.4143-.8782 2.2267-2.4172 2.5565-1.5155.3251-1.7843-.4968-2.0212-1.2217a6.5824 6.5824 0 0 0-.0769-.2266c-.2154-.5858-.1911-1.4119-.1574-2.5551.0165-.5612-.0249-1.9013-.3302-2.6462.0044-.2932.0106-.5909.019-.8918a.3529.3529 0 0 0-.0153-.1126 1.4927 1.4927 0 0 0-.0439-.208c-.1226-.4283-.4213-.7866-.7797-.9351-.1424-.059-.4038-.1672-.7178-.0869.067-.276.1831-.5875.309-.9249l.0529-.142c.0595-.16.134-.3257.213-.5012.4265-.9476 1.0106-2.2453.3766-5.1772-.2374-1.0981-1.0304-1.6343-2.2324-1.5098-.7207.0746-1.3799.3654-1.7088.5321a5.6716 5.6716 0 0 0-.1958.1041c.0918-1.1064.4386-3.1741 1.7357-4.4823a4.0306 4.0306 0 0 1 .3033-.276.3532.3532 0 0 0 .1447-.0644c.7524-.5706 1.6945-.8506 2.802-.8325.4091.0067.8017.0339 1.1742.081 1.939.3544 3.2439 1.4468 4.0359 2.3827.8143.9623 1.2552 1.9315 1.4312 2.4543-1.3232-.1346-2.2234.1268-2.6797.779-.9926 1.4189.543 4.1729 1.2811 5.4964.1353.2426.2522.4522.2889.5413.2403.5825.5515.9713.7787 1.2552.0696.087.1372.1714.1885.245-.4008.1155-1.1208.3825-1.0552 1.717-.0123.1563-.0423.4469-.0834.8148-.0461.2077-.0702.4603-.0994.7662zm.8905-1.6211c-.0405-.8316.2691-.9185.5967-1.0105a2.8566 2.8566 0 0 0 .135-.0406 1.202 1.202 0 0 0 .1342.103c.5703.3765 1.5823.4213 3.0068.1344-.2016.1769-.5189.3994-.9533.6011-.4098.1903-1.0957.333-1.7473.3636-.7197.0336-1.0859-.0807-1.1721-.151zm.5695-9.2712c-.0059.3508-.0542.6692-.1054 1.0017-.055.3576-.112.7274-.1264 1.1762-.0142.4368.0404.8909.0932 1.3301.1066.887.216 1.8003-.2075 2.7014a3.5272 3.5272 0 0 1-.1876-.3856c-.0527-.1276-.1669-.3326-.3251-.6162-.6156-1.1041-2.0574-3.6896-1.3193-4.7446.3795-.5427 1.3408-.5661 2.1781-.463zm.2284 7.0137a12.3762 12.3762 0 0 0-.0853-.1074l-.0355-.0444c.7262-1.1995.5842-2.3862.4578-3.4385-.0519-.4318-.1009-.8396-.0885-1.2226.0129-.4061.0666-.7543.1185-1.0911.0639-.415.1288-.8443.1109-1.3505.0134-.0531.0188-.1158.0118-.1902-.0457-.4855-.5999-1.938-1.7294-3.253-.6076-.7073-1.4896-1.4972-2.6889-2.0395.5251-.1066 1.2328-.2035 2.0244-.1859 2.0515.0456 3.6746.8135 4.8242 2.2824a.908.908 0 0 1 .0667.1002c.7231 1.3556-.2762 6.2751-2.9867 10.5405zm-8.8166-6.1162c-.025.1794-.3089.4225-.6211.4225a.5821.5821 0 0 1-.0809-.0056c-.1873-.026-.3765-.144-.5059-.3156-.0458-.0605-.1203-.178-.1055-.2844.0055-.0401.0261-.0985.0925-.1488.1182-.0894.3518-.1226.6096-.0867.3163.0441.6426.1938.6113.4186zm7.9305-.4114c.0111.0792-.049.201-.1531.3102-.0683.0717-.212.1961-.4079.2232a.5456.5456 0 0 1-.075.0052c-.2935 0-.5414-.2344-.5607-.3717-.024-.1765.2641-.3106.5611-.352.297-.0414.6111.0088.6356.1851z","PostgreSQL","slug","postgresql","Provides advanced database interaction capabilities for PostgreSQL, including detailed schema inspection with metadata, read-only query execution with safety checks, and tools for exploring database structure while enforcing security constraints.","hrpndt6je8","namespace","npmPackage",{"_33":121,"_152":153},"weeklyDownloads",84,"prompts","redditPostForeignId","resources","scores",{"_159":160,"_161":-5,"_162":-5},"license",0,"quality","security","simpleIcon","mcp-postgres-advanced","supportedPlatforms",[167],"MACOS","tools","y2webxuhv3","updatedAt","2025-05-12T02:00:19.515515611Z","meta",[174,177,179,186,189,191,194,197,200,203,206,208,211,214,216,218,220,222,224],{"_175":176},"title","PostgreSQL Advanced MCP Server | Glama",{"_178":42,"_33":31},"content",{"_180":181,"_182":183,"_184":185},"href","https://glama.ai/mcp/servers/@syahiidkamil/mcp-postgres-advanced","rel","canonical","tagName","link",{"_178":34,"_187":188},"property","og:title",{"_178":42,"_187":190},"og:description",{"_178":192,"_187":193},"https://glama.ai/logo.png","og:logo",{"_178":195,"_187":196},"https://glama.ai/mcp/servers/@syahiidkamil/mcp-postgres-advanced/og-image","og:image",{"_178":198,"_187":199},"630","og:image:height",{"_178":201,"_187":202},"1200","og:image:width",{"_178":204,"_187":205},"website","og:type",{"_178":181,"_187":207},"og:url",{"_178":209,"_187":210},"Glama – MCP Hosting Platform","og:site_name",{"_178":212,"_33":213},"summary_large_image","twitter:card",{"_178":209,"_33":215},"twitter:title",{"_178":42,"_33":217},"twitter:description",{"_178":195,"_33":219},"twitter:image",{"_178":198,"_33":221},"twitter:image:height",{"_178":201,"_33":223},"twitter:image:width",{"_225":226},"script:ld+json",{"_227":228,"_229":230},"@context","http://schema.org","@graph",[231],{"_227":232,"_233":234,"_235":236},"https://schema.org","@type","BreadcrumbList","itemListElement",[237,244,247,251],{"_233":238,"_239":240,"_33":241,"_242":243},"ListItem","item","https://glama.ai/","Glama","position",1,{"_233":238,"_239":245,"_33":246,"_242":129},"https://glama.ai/mcp","MCP",{"_233":238,"_239":248,"_33":249,"_242":250},"https://glama.ai/mcp/servers","Servers",3,{"_233":238,"_239":181,"_33":34,"_242":252},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_81":-5,"_29":256,"_172":271,"_306":-5},{"_84":85,"_86":257,"_13":261,"_105":42,"_106":42,"_107":262,"_111":263,"_133":-5,"_16":134,"_135":136,"_137":265,"_33":34,"_149":125,"_150":268,"_154":-5,"_155":-5,"_156":-5,"_157":269,"_163":-5,"_145":164,"_165":270,"_168":-5,"_126":169,"_170":171},{"_88":258,"_95":260,"_93":97},{"_90":259},{"_31":92,"_93":94},[90],[99,100,101,102,103,104],{"_35":43,"_109":110},{"_113":114,"_115":116,"_117":118,"_119":120,"_33":121,"_122":264,"_128":129,"_130":-5,"_131":132},{"_124":125,"_126":127},[266],{"_140":267,"_31":147,"_126":148},{"_142":143,"_33":144,"_145":146},{"_33":121,"_152":153},{"_159":160,"_161":-5,"_162":-5},[167],[272,274,276,278,280,281,282,283,284,285,286,287,288,289,290,291,292,293,294],{"_175":273},"Reviews | PostgreSQL Advanced MCP Server | Glama",{"_178":275,"_33":31},"Read community reviews and feedback for PostgreSQL Advanced MCP Server. Discover user experiences, ratings, strengths, and potential limitations of this MCP implementation from actual users.",{"_180":277,"_182":183,"_184":185},"https://glama.ai/mcp/servers/@syahiidkamil/mcp-postgres-advanced/reviews",{"_178":279,"_187":188},"Reviews | PostgreSQL Advanced MCP Server",{"_178":275,"_187":190},{"_178":192,"_187":193},{"_178":195,"_187":196},{"_178":198,"_187":199},{"_178":201,"_187":202},{"_178":204,"_187":205},{"_178":277,"_187":207},{"_178":209,"_187":210},{"_178":212,"_33":213},{"_178":209,"_33":215},{"_178":275,"_33":217},{"_178":195,"_33":219},{"_178":198,"_33":221},{"_178":201,"_33":223},{"_225":295},{"_227":228,"_229":296},[297],{"_227":232,"_233":234,"_235":298},[299,300,301,302,303],{"_233":238,"_239":240,"_33":241,"_242":243},{"_233":238,"_239":245,"_33":246,"_242":129},{"_233":238,"_239":248,"_33":249,"_242":250},{"_233":238,"_239":181,"_33":34,"_242":252},{"_233":238,"_239":277,"_33":304,"_242":305},"Reviews",5,"review","actionData","errors"]

Rate & Review

MCP directory API