@marcelo-ochoa/server-postgres 1.0.2 → 1.0.4

package/README.md

@@ -26,6 +26,9 @@ A Model Context Protocol server that provides read-only access to PostgreSQL dat
     - `user` (string): The PostgreSQL username
     - `password` (string): The PostgreSQL password
 
+Example:
+ pg-connect host.docker.internal:5432/postgres postgres pg_2025
+
 - **pg-awr**
   - Generate a PostgreSQL performance report similar to Oracle AWR. Includes database statistics, top queries (requires pg_stat_statements extension), table/index statistics, connection info, and optimization recommendations.
 
@@ -44,14 +47,14 @@ See [Change Log](https://github.com/marcelo-ochoa/servers/blob/main/src/postgres
 
 ## Configuration
 
-### Authentication
+The PostgreSQL server uses environment variables or the `pg-connect` tool for secure credential management:
 
-The PostgreSQL server uses environment variables for secure credential management:
+- **`PG_USER`**: PostgreSQL username (optional if using `pg-connect`)
+- **`PG_PASSWORD`**: PostgreSQL password (optional if using `pg-connect`)
 
-- **`PG_USER`**: PostgreSQL username (required)
-- **`PG_PASSWORD`**: PostgreSQL password (required)
+### Connection String
 
-The connection string should contain only the host, port, and database information (without embedded credentials).
+The connection string should contain only the host, port, and database information (without embedded credentials). Providing it as a command-line argument is **optional**. If omitted at startup, you must use the `pg-connect` tool to establish a connection before using other functionality.
 
 **Supported connection string formats:**
 - `postgresql://host:port/dbname`
@@ -77,14 +80,15 @@ To use this server with the Claude Desktop app, add the following configuration
         "--rm",
         "-e", "PG_USER=myuser",
         "-e", "PG_PASSWORD=mypassword",
-        "mochoa/mcp-postgres", 
-        "postgresql://host.docker.internal:5432/mydb"
+        "mochoa/mcp-postgres"
       ]
     }
   }
 }
 ```
 
+Note: You can still provide the connection string as a final argument if you want to connect automatically on startup: `"args": [..., "mochoa/mcp-postgres", "postgresql://host.docker.internal:5432/mydb"]`.
+
 ### NPX
 
 ```json
@@ -94,8 +98,7 @@ To use this server with the Claude Desktop app, add the following configuration
       "command": "npx",
       "args": [
         "-y",
-        "@marcelo-ochoa/server-postgres",
-        "postgresql://localhost:5432/mydb"
+        "@marcelo-ochoa/server-postgres"
       ],
       "env": {
         "PG_USER": "myuser",
@@ -135,11 +138,6 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
 {
   "mcp": {
     "inputs": [
-      {
-        "type": "promptString",
-        "id": "pg_url",
-        "description": "PostgreSQL URL (e.g. postgresql://host.docker.internal:5432/mydb)"
-      },
       {
         "type": "promptString",
         "id": "pg_user",
@@ -161,8 +159,7 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
           "--rm",
           "-e", "PG_USER=${input:pg_user}",
           "-e", "PG_PASSWORD=${input:pg_password}",
-          "mochoa/mcp-postgres",
-          "${input:pg_url}"
+          "mochoa/mcp-postgres"
         ]
       }
     }
@@ -170,17 +167,14 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
 }
 ```
 
+Note: You can add an input for `pg_url` and append it to `args` if you want to connect on startup.
+
 ### NPX
 
 ```json
 {
   "mcp": {
     "inputs": [
-      {
-        "type": "promptString",
-        "id": "pg_url",
-        "description": "PostgreSQL URL (e.g. postgresql://localhost:5432/mydb)"
-      },
       {
         "type": "promptString",
         "id": "pg_user",
@@ -198,8 +192,7 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
         "command": "npx",
         "args": [
           "-y",
-          "@marcelo-ochoa/server-postgres",
-          "${input:pg_url}"
+          "@marcelo-ochoa/server-postgres"
         ],
         "env": {
           "PG_USER": "${input:pg_user}",
@@ -215,6 +208,10 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
 
 See [PostgreSQL AWR in action](https://github.com/marcelo-ochoa/servers/blob/main/src/postgres/AWR_example.md) for an example of a performance report generated by the `pg-awr` tool for a production Moodle database, highlighting critical performance issues and optimization opportunities.
 
+## Demos
+
+See [Demos](https://github.com/marcelo-ochoa/servers/blob/main/src/postgres/Demos.md) for usage examples with Claude Desktop, Docker AI, Gemini CLI, and Antigravity Code Editor.
+
 ## Building
 
 Docker:

package/dist/db.js

@@ -52,13 +52,13 @@ export async function initializePool(connectionString) {
 }
 export function getPool() {
     if (!pool) {
-        throw new Error("Postgres connection pool not initialized.");
+        throw new Error("Postgres connection pool not initialized. Use pg-connect tool first.");
     }
     return pool;
 }
 export function getResourceBaseUrl() {
     if (!resourceBaseUrl) {
-        throw new Error("Resource Base URL not initialized.");
+        throw new Error("Resource Base URL not initialized. Use pg-connect tool first.");
     }
     return resourceBaseUrl;
 }

package/dist/server.js

@@ -7,7 +7,7 @@ import { listResourcesHandler, readResourceHandler, callToolHandler } from "./ha
 import { tools } from "./tools.js";
 const server = new Server({
     name: "postgres-server",
-    version: "1.0.2",
+    version: "1.0.4",
 }, {
     capabilities: {
         resources: {},
@@ -48,17 +48,18 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
 server.setRequestHandler(CallToolRequestSchema, callToolHandler);
 export async function runServer() {
     const args = process.argv.slice(2);
-    if (args.length === 0) {
-        console.error("Please provide a database URL as a command-line argument");
-        process.exit(1);
-    }
     const databaseUrl = args[0];
-    try {
-        await initializePool(databaseUrl);
+    if (databaseUrl) {
+        try {
+            await initializePool(databaseUrl);
+        }
+        catch (error) {
+            console.error("Failed to initialize database pool:", error);
+            process.exit(1);
+        }
     }
-    catch (error) {
-        console.error("Failed to initialize database pool:", error);
-        process.exit(1);
+    else {
+        console.error("Warning: No database URL provided. Use pg-connect tool before using other functionality.");
     }
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "@marcelo-ochoa/server-postgres",
   "mcpName": "io.github.marcelo-ochoa/postgres",
-  "version": "1.0.2",
-  "description": "MCP server for interacting with PostgreSQL databases",
+  "version": "1.0.4",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/marcelo-ochoa/servers.git",
+    "subfolder": "src/postgres"
+  },
+  "description": "An MCP server for PostgreSQL databases.",
   "keywords": [
     "read-only-mcp",
     "postgres-database",