nuuly-postgres-mcp-server 1.0.0__tar.gz → 1.0.2__tar.gz

nuuly_postgres_mcp_server-1.0.2/PKG-INFO

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: nuuly-postgres-mcp-server
+Version: 1.0.2
+Summary: MCP server for accessing Nuuly PostgreSQL database resources
+Author-email: Nuuly Engineering <engineering@nuuly.com>
+License: Proprietary
+Project-URL: Homepage, https://github.com/urbn/r15-mcp
+Project-URL: Repository, https://github.com/urbn/r15-mcp
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp>=2.2.1
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: psycopg2-binary>=2.9.5
+
+# Nuuly Postgres MCP Server
+
+This MCP server provides AI code editors with access to PostgreSQL databases through the Model Context Protocol (MCP). It allows AI assistants to understand database schemas, tables, and to run queries against non-prod PostgreSQL databases. This implementation acts as a client that forwards requests to a remote PostgreSQL MCP server running on Google Cloud Run.
+
+## Features
+
+- List available PostgreSQL databases and their aliases
+- Get detailed schema information for all tables in a database
+- Run SQL queries against PostgreSQL databases
+
+## Prerequisites
+
+- Python 3.8+
+
+## Installation
+
+### Step 1: Install Python (Mac Users)
+
+**Option A: Using Homebrew (Recommended)**
+
+1. Open Terminal
+2. Check if Homebrew is installed by typing: `brew --version`
+3. If Homebrew is not installed, install it by copying and pasting this command:
+   ```bash
+   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+   ```
+4. Once Homebrew is installed, install Python:
+   ```bash
+   brew install python
+   ```
+
+**Option B: Download Python directly**
+
+1. Go to [python.org](https://www.python.org/downloads/)
+2. Download Python 3.8 or newer
+3. Run the installer and follow the prompts
+
+### Step 2: Install the Postgres MCP Server
+
+1. Open Terminal
+2. Install the server by running:
+   ```bash
+   pip install nuuly-postgres-mcp-server
+   ```
+3. Wait for the installation to complete
+
+### Step 3: Find the Installation Path
+
+You'll need to find where the server was installed to configure Claude:
+
+1. In Terminal, run:
+   ```bash
+   which nuuly-postgres-mcp
+   ```
+2. This will show something like:   
+   `/Users/yourname/Library/Python/3.12/bin/nuuly-postgres-mcp`
+3. **Copy this path** - you'll need it for the next step
+
+### Step 4: Configure Claude Desktop
+
+1. Open Claude Desktop application
+2. Find the "MCP Servers" section
+3. Click "Edit Config" or open the configuration file
+4. Add the following configuration, replacing the path with your actual path from Step 3:
+
+```json
+{
+  "nuuly-postgres-mcp": {
+    "command": "/Users/yourname/Library/Python/3.12/bin/nuuly-postgres-mcp",
+    "env": {
+      "PYTHONUNBUFFERED": "1",
+      "POSTGRES_MCP_SERVER_URL": "https://postgres-mcp-toolbox-186512416539.us-east4.run.app",
+      "DB_PROXY_API_KEY": "YOUR_API_KEY_HERE"
+    }
+  }
+}
+```
+
+**Environment URLs:**
+- **Dev** (rental-dev): `https://postgres-mcp-toolbox-186512416539.us-east4.run.app`
+- **Staging** (rental-staging): `https://postgres-mcp-toolbox-526194183507.us-east4.run.app`
+
+Use `POSTGRES_MCP_SERVER_URL` to switch between dev and staging.
+
+### Step 5: Restart Claude
+
+1. Restart Claude Desktop
+2. The PostgreSQL tools should now be available
+
+## Available Tools
+
+The server provides the following tools, which are forwarded to the remote PostgreSQL MCP server:
+
+### 1. list_databases
+
+Lists all databases and their aliases accessible via the Cloud Run DB Proxy.
+
+```python
+list_databases()
+```
+
+Example response:
+```json
+{
+  "databases": [
+    {
+      "name": "orders",
+      "aliases": ["orders_db", "order_system"],
+      "instance": "rental-dev:us-east4:orders-db"
+    },
+    {
+      "name": "products",
+      "aliases": ["product_db"],
+      "instance": "rental-dev:us-east4:product-db"
+    }
+  ]
+}
+```
+
+### 2. get_schema
+
+Gets the schema of all tables in the specified database.
+
+```python
+get_schema(database="orders")
+```
+
+Example response:
+```json
+{
+  "tables": [
+    {
+      "name": "orders",
+      "columns": [
+        {
+          "name": "id",
+          "type": "integer",
+          "nullable": false,
+          "primary_key": true
+        },
+        {
+          "name": "customer_id",
+          "type": "integer",
+          "nullable": false,
+          "foreign_key": {
+            "table": "customers",
+            "column": "id"
+          }
+        },
+        {
+          "name": "created_at",
+          "type": "timestamp",
+          "nullable": false
+        }
+      ]
+    }
+  ],
+  "success": true
+}
+```
+
+### 3. run_query
+
+Runs a SQL query against the database and returns results.
+
+```python
+run_query(database="orders", sql="SELECT * FROM orders LIMIT 10")
+```
+
+Example response:
+```json
+{
+  "columns": ["id", "customer_id", "created_at"],
+  "rows": [
+    [1001, 5001, "2023-01-15T10:30:00Z"],
+    [1002, 5002, "2023-01-15T11:45:00Z"]
+  ],
+  "count": 2,
+  "success": true
+}
+```
+
+## Backend Deployment
+
+The Postgres MCP client forwards requests to a Cloud Run DB Proxy. The backend is deployed via Terraform in `infra_tools/postgres_mcp_server/terraform/`:
+
+- **Dev**: `rental-dev`, `config/dev.yaml`, Cloud SQL private IPs
+- **Staging**: `rental-staging`, `config/staging.yaml`, Cloud SQL + AlloyDB private IPs
+- Region: `us-east4`
+- VPC Connector: `rental-vpc-connector`
+
+See `infra_tools/postgres_mcp_server/README.md` for build and deploy instructions.
+
+## Troubleshooting
+
+### Connection Issues with Claude Desktop
+
+If you experience connection issues with Claude Desktop, ensure that:
+
+1. The server is running with the correct URL for the Cloud Run DB Proxy
+2. The API key is correctly set in your configuration
+3. The server is properly handling heartbeat and shutdown messages
+4. The JSON-RPC initialization response includes `keepAlive: true` and `supportsHeartbeats: true`
+
+Example curl commands to test the API:
+```bash
+# Dev
+curl -X GET "https://postgres-mcp-toolbox-186512416539.us-east4.run.app/databases" -H 'x-api-key: YOUR_API_KEY_HERE'
+
+# Staging
+curl -X GET "https://postgres-mcp-toolbox-526194183507.us-east4.run.app/databases" -H 'x-api-key: YOUR_API_KEY_HERE'
+```
+
+### Common Issues
+
+- **Missing API Key**: Ensure the `DB_PROXY_API_KEY` environment variable is set
+- **Permission Errors**: Verify that your API key has the necessary permissions
+- **Timeout Errors**: Check network latency or increase the timeout settings in the code
+- **Heartbeat Issues**: Ensure the MCP server properly implements heartbeat handlers

nuuly_postgres_mcp_server-1.0.2/README.md

@@ -0,0 +1,219 @@
+# Nuuly Postgres MCP Server
+
+This MCP server provides AI code editors with access to PostgreSQL databases through the Model Context Protocol (MCP). It allows AI assistants to understand database schemas, tables, and to run queries against non-prod PostgreSQL databases. This implementation acts as a client that forwards requests to a remote PostgreSQL MCP server running on Google Cloud Run.
+
+## Features
+
+- List available PostgreSQL databases and their aliases
+- Get detailed schema information for all tables in a database
+- Run SQL queries against PostgreSQL databases
+
+## Prerequisites
+
+- Python 3.8+
+
+## Installation
+
+### Step 1: Install Python (Mac Users)
+
+**Option A: Using Homebrew (Recommended)**
+
+1. Open Terminal
+2. Check if Homebrew is installed by typing: `brew --version`
+3. If Homebrew is not installed, install it by copying and pasting this command:
+   ```bash
+   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+   ```
+4. Once Homebrew is installed, install Python:
+   ```bash
+   brew install python
+   ```
+
+**Option B: Download Python directly**
+
+1. Go to [python.org](https://www.python.org/downloads/)
+2. Download Python 3.8 or newer
+3. Run the installer and follow the prompts
+
+### Step 2: Install the Postgres MCP Server
+
+1. Open Terminal
+2. Install the server by running:
+   ```bash
+   pip install nuuly-postgres-mcp-server
+   ```
+3. Wait for the installation to complete
+
+### Step 3: Find the Installation Path
+
+You'll need to find where the server was installed to configure Claude:
+
+1. In Terminal, run:
+   ```bash
+   which nuuly-postgres-mcp
+   ```
+2. This will show something like:   
+   `/Users/yourname/Library/Python/3.12/bin/nuuly-postgres-mcp`
+3. **Copy this path** - you'll need it for the next step
+
+### Step 4: Configure Claude Desktop
+
+1. Open Claude Desktop application
+2. Find the "MCP Servers" section
+3. Click "Edit Config" or open the configuration file
+4. Add the following configuration, replacing the path with your actual path from Step 3:
+
+```json
+{
+  "nuuly-postgres-mcp": {
+    "command": "/Users/yourname/Library/Python/3.12/bin/nuuly-postgres-mcp",
+    "env": {
+      "PYTHONUNBUFFERED": "1",
+      "POSTGRES_MCP_SERVER_URL": "https://postgres-mcp-toolbox-186512416539.us-east4.run.app",
+      "DB_PROXY_API_KEY": "YOUR_API_KEY_HERE"
+    }
+  }
+}
+```
+
+**Environment URLs:**
+- **Dev** (rental-dev): `https://postgres-mcp-toolbox-186512416539.us-east4.run.app`
+- **Staging** (rental-staging): `https://postgres-mcp-toolbox-526194183507.us-east4.run.app`
+
+Use `POSTGRES_MCP_SERVER_URL` to switch between dev and staging.
+
+### Step 5: Restart Claude
+
+1. Restart Claude Desktop
+2. The PostgreSQL tools should now be available
+
+## Available Tools
+
+The server provides the following tools, which are forwarded to the remote PostgreSQL MCP server:
+
+### 1. list_databases
+
+Lists all databases and their aliases accessible via the Cloud Run DB Proxy.
+
+```python
+list_databases()
+```
+
+Example response:
+```json
+{
+  "databases": [
+    {
+      "name": "orders",
+      "aliases": ["orders_db", "order_system"],
+      "instance": "rental-dev:us-east4:orders-db"
+    },
+    {
+      "name": "products",
+      "aliases": ["product_db"],
+      "instance": "rental-dev:us-east4:product-db"
+    }
+  ]
+}
+```
+
+### 2. get_schema
+
+Gets the schema of all tables in the specified database.
+
+```python
+get_schema(database="orders")
+```
+
+Example response:
+```json
+{
+  "tables": [
+    {
+      "name": "orders",
+      "columns": [
+        {
+          "name": "id",
+          "type": "integer",
+          "nullable": false,
+          "primary_key": true
+        },
+        {
+          "name": "customer_id",
+          "type": "integer",
+          "nullable": false,
+          "foreign_key": {
+            "table": "customers",
+            "column": "id"
+          }
+        },
+        {
+          "name": "created_at",
+          "type": "timestamp",
+          "nullable": false
+        }
+      ]
+    }
+  ],
+  "success": true
+}
+```
+
+### 3. run_query
+
+Runs a SQL query against the database and returns results.
+
+```python
+run_query(database="orders", sql="SELECT * FROM orders LIMIT 10")
+```
+
+Example response:
+```json
+{
+  "columns": ["id", "customer_id", "created_at"],
+  "rows": [
+    [1001, 5001, "2023-01-15T10:30:00Z"],
+    [1002, 5002, "2023-01-15T11:45:00Z"]
+  ],
+  "count": 2,
+  "success": true
+}
+```
+
+## Backend Deployment
+
+The Postgres MCP client forwards requests to a Cloud Run DB Proxy. The backend is deployed via Terraform in `infra_tools/postgres_mcp_server/terraform/`:
+
+- **Dev**: `rental-dev`, `config/dev.yaml`, Cloud SQL private IPs
+- **Staging**: `rental-staging`, `config/staging.yaml`, Cloud SQL + AlloyDB private IPs
+- Region: `us-east4`
+- VPC Connector: `rental-vpc-connector`
+
+See `infra_tools/postgres_mcp_server/README.md` for build and deploy instructions.
+
+## Troubleshooting
+
+### Connection Issues with Claude Desktop
+
+If you experience connection issues with Claude Desktop, ensure that:
+
+1. The server is running with the correct URL for the Cloud Run DB Proxy
+2. The API key is correctly set in your configuration
+3. The server is properly handling heartbeat and shutdown messages
+4. The JSON-RPC initialization response includes `keepAlive: true` and `supportsHeartbeats: true`
+
+Example curl commands to test the API:
+```bash
+# Dev
+curl -X GET "https://postgres-mcp-toolbox-186512416539.us-east4.run.app/databases" -H 'x-api-key: YOUR_API_KEY_HERE'
+
+# Staging
+curl -X GET "https://postgres-mcp-toolbox-526194183507.us-east4.run.app/databases" -H 'x-api-key: YOUR_API_KEY_HERE'
+```
+
+### Common Issues
+
+- **Missing API Key**: Ensure the `DB_PROXY_API_KEY` environment variable is set
+- **Permission Errors**: Verify that your API key has the necessary permissions
+- **Timeout Errors**: Check network latency or increase the timeout settings in the code
+- **Heartbeat Issues**: Ensure the MCP server properly implements heartbeat handlers

{nuuly_postgres_mcp_server-1.0.0 → nuuly_postgres_mcp_server-1.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "nuuly-postgres-mcp-server"
-version = "1.0.0"
+version = "1.0.2"
 description = "MCP server for accessing Nuuly PostgreSQL database resources"
 readme = "README.md"
 authors = [{name = "Nuuly Engineering", email = "engineering@nuuly.com"}]

{nuuly_postgres_mcp_server-1.0.0 → nuuly_postgres_mcp_server-1.0.2}/src/nuuly_postgres_mcp_server/__init__.py

@@ -4,5 +4,5 @@ Nuuly Postgres MCP Server package.
 
 from .server import run
 
-__version__ = "1.0.0"
+__version__ = "1.0.2"
 __all__ = ["run"]

{nuuly_postgres_mcp_server-1.0.0 → nuuly_postgres_mcp_server-1.0.2}/src/nuuly_postgres_mcp_server/server.py

@@ -13,7 +13,7 @@ from typing import Any, Dict, Optional
 logger = logging.getLogger(__name__)
 
 # Configuration for Cloud Run DB Proxy
-CLOUD_RUN_PROXY_URL = os.getenv("CLOUD_RUN_PROXY_URL", "https://www.example.com")
+POSTGRES_MCP_SERVER_URL = os.getenv("POSTGRES_MCP_SERVER_URL", "https://www.example.com")
 db_proxy_api_key = os.getenv("DB_PROXY_API_KEY")
 
 # Import FastMCP
@@ -45,13 +45,13 @@ async def run_query(ctx: Context, database: str, sql: str) -> str:
             "sql": sql
         }
         headers = {"X-API-KEY": db_proxy_api_key}
-        url = f"{CLOUD_RUN_PROXY_URL}/query"
+        url = f"{POSTGRES_MCP_SERVER_URL}/query"
         
         logger.info(f"Executing query on database: {database}")
         async with httpx.AsyncClient(timeout=15) as client:
             response = await client.post(url, json=payload, headers=headers)
             response.raise_for_status()
-            return response.json()
+            return json.dumps(response.json())
     except httpx.HTTPStatusError as e:
         logger.error(f"HTTPStatusError: status={e.response.status_code}, body={e.response.text}")
         return json.dumps({"error": f"Cloud Run proxy error: {e.response.status_code}", "details": e.response.text})
@@ -80,13 +80,13 @@ async def get_schema(ctx: Context, database: str) -> str:
             
         payload = {"database": database}
         headers = {"X-API-KEY": db_proxy_api_key}
-        url = f"{CLOUD_RUN_PROXY_URL}/schema"
+        url = f"{POSTGRES_MCP_SERVER_URL}/schema"
         
         logger.info(f"Fetching schema for database: {database}")
         async with httpx.AsyncClient(timeout=15) as client:
             response = await client.post(url, json=payload, headers=headers)
             response.raise_for_status()
-            return response.json()
+            return json.dumps(response.json())
     except httpx.HTTPStatusError as e:
         logger.error(f"HTTPStatusError: status={e.response.status_code}, body={e.response.text}")
         return json.dumps({"error": f"Cloud Run proxy error: {e.response.status_code}", "details": e.response.text})
@@ -110,13 +110,13 @@ async def list_databases(ctx: Context) -> str:
             return json.dumps({"error": "DB_PROXY_API_KEY environment variable not set"})
             
         headers = {"X-API-KEY": db_proxy_api_key}
-        url = f"{CLOUD_RUN_PROXY_URL}/databases"
+        url = f"{POSTGRES_MCP_SERVER_URL}/databases"
         
         logger.info("Listing available databases")
         async with httpx.AsyncClient(timeout=15) as client:
             response = await client.get(url, headers=headers)
             response.raise_for_status()
-            return response.json()
+            return json.dumps(response.json())
     except httpx.HTTPStatusError as e:
         logger.error(f"HTTPStatusError: status={e.response.status_code}, body={e.response.text}")
         return json.dumps({"error": f"Cloud Run proxy error: {e.response.status_code}", "details": e.response.text})

nuuly_postgres_mcp_server-1.0.2/src/nuuly_postgres_mcp_server.egg-info/PKG-INFO

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: nuuly-postgres-mcp-server
+Version: 1.0.2
+Summary: MCP server for accessing Nuuly PostgreSQL database resources
+Author-email: Nuuly Engineering <engineering@nuuly.com>
+License: Proprietary
+Project-URL: Homepage, https://github.com/urbn/r15-mcp
+Project-URL: Repository, https://github.com/urbn/r15-mcp
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp>=2.2.1
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: psycopg2-binary>=2.9.5
+
+# Nuuly Postgres MCP Server
+
+This MCP server provides AI code editors with access to PostgreSQL databases through the Model Context Protocol (MCP). It allows AI assistants to understand database schemas, tables, and to run queries against non-prod PostgreSQL databases. This implementation acts as a client that forwards requests to a remote PostgreSQL MCP server running on Google Cloud Run.
+
+## Features
+
+- List available PostgreSQL databases and their aliases
+- Get detailed schema information for all tables in a database
+- Run SQL queries against PostgreSQL databases
+
+## Prerequisites
+
+- Python 3.8+
+
+## Installation
+
+### Step 1: Install Python (Mac Users)
+
+**Option A: Using Homebrew (Recommended)**
+
+1. Open Terminal
+2. Check if Homebrew is installed by typing: `brew --version`
+3. If Homebrew is not installed, install it by copying and pasting this command:
+   ```bash
+   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+   ```
+4. Once Homebrew is installed, install Python:
+   ```bash
+   brew install python
+   ```
+
+**Option B: Download Python directly**
+
+1. Go to [python.org](https://www.python.org/downloads/)
+2. Download Python 3.8 or newer
+3. Run the installer and follow the prompts
+
+### Step 2: Install the Postgres MCP Server
+
+1. Open Terminal
+2. Install the server by running:
+   ```bash
+   pip install nuuly-postgres-mcp-server
+   ```
+3. Wait for the installation to complete
+
+### Step 3: Find the Installation Path
+
+You'll need to find where the server was installed to configure Claude:
+
+1. In Terminal, run:
+   ```bash
+   which nuuly-postgres-mcp
+   ```
+2. This will show something like:   
+   `/Users/yourname/Library/Python/3.12/bin/nuuly-postgres-mcp`
+3. **Copy this path** - you'll need it for the next step
+
+### Step 4: Configure Claude Desktop
+
+1. Open Claude Desktop application
+2. Find the "MCP Servers" section
+3. Click "Edit Config" or open the configuration file
+4. Add the following configuration, replacing the path with your actual path from Step 3:
+
+```json
+{
+  "nuuly-postgres-mcp": {
+    "command": "/Users/yourname/Library/Python/3.12/bin/nuuly-postgres-mcp",
+    "env": {
+      "PYTHONUNBUFFERED": "1",
+      "POSTGRES_MCP_SERVER_URL": "https://postgres-mcp-toolbox-186512416539.us-east4.run.app",
+      "DB_PROXY_API_KEY": "YOUR_API_KEY_HERE"
+    }
+  }
+}
+```
+
+**Environment URLs:**
+- **Dev** (rental-dev): `https://postgres-mcp-toolbox-186512416539.us-east4.run.app`
+- **Staging** (rental-staging): `https://postgres-mcp-toolbox-526194183507.us-east4.run.app`
+
+Use `POSTGRES_MCP_SERVER_URL` to switch between dev and staging.
+
+### Step 5: Restart Claude
+
+1. Restart Claude Desktop
+2. The PostgreSQL tools should now be available
+
+## Available Tools
+
+The server provides the following tools, which are forwarded to the remote PostgreSQL MCP server:
+
+### 1. list_databases
+
+Lists all databases and their aliases accessible via the Cloud Run DB Proxy.
+
+```python
+list_databases()
+```
+
+Example response:
+```json
+{
+  "databases": [
+    {
+      "name": "orders",
+      "aliases": ["orders_db", "order_system"],
+      "instance": "rental-dev:us-east4:orders-db"
+    },
+    {
+      "name": "products",
+      "aliases": ["product_db"],
+      "instance": "rental-dev:us-east4:product-db"
+    }
+  ]
+}
+```
+
+### 2. get_schema
+
+Gets the schema of all tables in the specified database.
+
+```python
+get_schema(database="orders")
+```
+
+Example response:
+```json
+{
+  "tables": [
+    {
+      "name": "orders",
+      "columns": [
+        {
+          "name": "id",
+          "type": "integer",
+          "nullable": false,
+          "primary_key": true
+        },
+        {
+          "name": "customer_id",
+          "type": "integer",
+          "nullable": false,
+          "foreign_key": {
+            "table": "customers",
+            "column": "id"
+          }
+        },
+        {
+          "name": "created_at",
+          "type": "timestamp",
+          "nullable": false
+        }
+      ]
+    }
+  ],
+  "success": true
+}
+```
+
+### 3. run_query
+
+Runs a SQL query against the database and returns results.
+
+```python
+run_query(database="orders", sql="SELECT * FROM orders LIMIT 10")
+```
+
+Example response:
+```json
+{
+  "columns": ["id", "customer_id", "created_at"],
+  "rows": [
+    [1001, 5001, "2023-01-15T10:30:00Z"],
+    [1002, 5002, "2023-01-15T11:45:00Z"]
+  ],
+  "count": 2,
+  "success": true
+}
+```
+
+## Backend Deployment
+
+The Postgres MCP client forwards requests to a Cloud Run DB Proxy. The backend is deployed via Terraform in `infra_tools/postgres_mcp_server/terraform/`:
+
+- **Dev**: `rental-dev`, `config/dev.yaml`, Cloud SQL private IPs
+- **Staging**: `rental-staging`, `config/staging.yaml`, Cloud SQL + AlloyDB private IPs
+- Region: `us-east4`
+- VPC Connector: `rental-vpc-connector`
+
+See `infra_tools/postgres_mcp_server/README.md` for build and deploy instructions.
+
+## Troubleshooting
+
+### Connection Issues with Claude Desktop
+
+If you experience connection issues with Claude Desktop, ensure that:
+
+1. The server is running with the correct URL for the Cloud Run DB Proxy
+2. The API key is correctly set in your configuration
+3. The server is properly handling heartbeat and shutdown messages
+4. The JSON-RPC initialization response includes `keepAlive: true` and `supportsHeartbeats: true`
+
+Example curl commands to test the API:
+```bash
+# Dev
+curl -X GET "https://postgres-mcp-toolbox-186512416539.us-east4.run.app/databases" -H 'x-api-key: YOUR_API_KEY_HERE'
+
+# Staging
+curl -X GET "https://postgres-mcp-toolbox-526194183507.us-east4.run.app/databases" -H 'x-api-key: YOUR_API_KEY_HERE'
+```
+
+### Common Issues
+
+- **Missing API Key**: Ensure the `DB_PROXY_API_KEY` environment variable is set
+- **Permission Errors**: Verify that your API key has the necessary permissions
+- **Timeout Errors**: Check network latency or increase the timeout settings in the code
+- **Heartbeat Issues**: Ensure the MCP server properly implements heartbeat handlers

nuuly_postgres_mcp_server-1.0.0/PKG-INFO

@@ -1,179 +0,0 @@
-Metadata-Version: 2.4
-Name: nuuly-postgres-mcp-server
-Version: 1.0.0
-Summary: MCP server for accessing Nuuly PostgreSQL database resources
-Author-email: Nuuly Engineering <engineering@nuuly.com>
-License: Proprietary
-Project-URL: Homepage, https://github.com/urbn/r15-mcp
-Project-URL: Repository, https://github.com/urbn/r15-mcp
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: fastmcp>=2.2.1
-Requires-Dist: httpx>=0.24.0
-Requires-Dist: psycopg2-binary>=2.9.5
-
-# Nuuly Postgres MCP Server
-
-MCP server for accessing Nuuly PostgreSQL database resources through Claude Desktop and other AI assistants.
-
-## Contents
-- `src/nuuly_postgres_mcp_server/`: Package source code
-  - `__init__.py`: Package initialization
-  - `__main__.py`: Entry point for running as a module
-  - `server.py`: Main server implementation
-- `pyproject.toml`: Package configuration
-- `.env.example`: Example environment variables
-
-## Purpose
-This MCP server provides PostgreSQL database connectivity functionality for the broader MCP platform. It connects to CloudSQL Postgres non-prod databases and enables AI code editors to:
-
-1. Understand all tables and schemas
-2. Run queries against the non-prod database
-3. List available databases and their aliases
-
----
-
-## Installation
-
-### Option 1: Install from PyPI
-
-```bash
-pip install nuuly-postgres-mcp-server
-```
-
-### Option 2: Install from Source
-
-1. Clone the repository:
-```bash
-git clone <REPO_URL>
-cd r15-mcp/mcp_servers/postgres-mcp
-```
-
-2. Install the package in development mode:
-```bash
-pip install -e .
-```
-
-## Local Development
-
-### Prerequisites
-- Python 3.8 or higher
-- pip package manager
-
-### Setup
-
-1. Clone the repository:
-```bash
-git clone <REPO_URL>
-cd r15-mcp/mcp_servers/postgres-mcp
-```
-
-2. Create and activate a virtual environment (optional but recommended):
-```bash
-python -m venv venv
-source venv/bin/activate  # On Windows: venv\Scripts\activate
-```
-
-3. Install development dependencies:
-```bash
-pip install -e .
-```
-
-4. Set up environment variables:
-```bash
-cp .env.example .env
-# Edit .env with your actual values
-```
-
-## Environment Variables
-
-The following environment variables can be set to customize the behavior of the MCP server:
-
-- `CLOUD_RUN_PROXY_URL`: URL of the Cloud Run DB Proxy (default: "https://postgres-mcp-toolbox-186512416539.us-east4.run.app")
-- `DB_PROXY_API_KEY`: API key for authenticating with the Cloud Run DB Proxy (required)
-- `LOG_LEVEL`: Logging level (default: INFO)
-
-## Usage
-
-### For Claude Desktop
-
-Add this configuration to your Claude Desktop settings:
-
-```json
-{
-  "Nuuly Postgres MCP": {
-    "command": "nuuly-postgres-mcp",
-    "env": {
-      "PYTHONUNBUFFERED": "1",
-      "CLOUD_RUN_PROXY_URL": "https://postgres-mcp-toolbox-186512416539.us-east4.run.app",
-      "DB_PROXY_API_KEY": "YOUR_API_KEY_HERE"
-    }
-  }
-}
-```
-
-### Command Line Usage
-
-```bash
-nuuly-postgres-mcp
-```
-
-## Deployment
-
-### As a GCP Cloud Function
-
-This MCP server is designed to be deployed as a GCP Cloud Function with the following parameters:
-
-- Project: `rental-dev`
-- Region: `us-east4`
-- Serverless VPC Connector: `rental-vpc-connector`
-- Entry point: `main.py`
-
-The function connects to CloudSQL PostgreSQL using private IP (10.171.208.52) and uses environment variables for DB credentials.
-
-```yaml
-environment_variables:
-  CLOUD_RUN_PROXY_URL: "https://postgres-mcp-toolbox-186512416539.us-east4.run.app"
-  DB_PROXY_API_KEY: "${DB_PROXY_API_KEY}"
-  LOG_LEVEL: "INFO"
-```
-
-### Building and Publishing the Package
-
-To build and publish the package to PyPI:
-
-```bash
-python -m build
-python -m twine upload dist/*
-```
-
-## Available Tools
-
-This MCP server provides the following tools to AI assistants:
-
-- `run_query`: Execute SQL queries against the database
-- `get_schema`: Get database schema information
-- `list_databases`: List available databases
-
-## Troubleshooting
-
-### Connection Issues with Claude Desktop
-
-If you experience connection issues with Claude Desktop (client transport closing), ensure that:
-
-1. The server is running with the correct URL for the Cloud Run DB Proxy
-2. The API key is correctly set and properly escaped in any curl commands (use single quotes)
-3. The server is properly handling heartbeat and shutdown messages
-4. The JSON-RPC initialization response includes `keepAlive: true` and `supportsHeartbeats: true`
-
-Example curl command to test the API:
-```bash
-curl -X GET "https://postgres-mcp-toolbox-186512416539.us-east4.run.app/databases" -H 'X-API-KEY: YOUR_API_KEY_HERE'
-```
-
-### Common Issues
-
-- **Missing API Key**: Ensure the `DB_PROXY_API_KEY` environment variable is set
-- **Permission Errors**: Verify that your API key has the necessary permissions
-- **Timeout Errors**: Check network latency or increase the timeout settings in the code
-- **Heartbeat Issues**: Ensure the MCP server properly implements heartbeat handlers

nuuly_postgres_mcp_server-1.0.0/README.md

@@ -1,165 +0,0 @@
-# Nuuly Postgres MCP Server
-
-MCP server for accessing Nuuly PostgreSQL database resources through Claude Desktop and other AI assistants.
-
-## Contents
-- `src/nuuly_postgres_mcp_server/`: Package source code
-  - `__init__.py`: Package initialization
-  - `__main__.py`: Entry point for running as a module
-  - `server.py`: Main server implementation
-- `pyproject.toml`: Package configuration
-- `.env.example`: Example environment variables
-
-## Purpose
-This MCP server provides PostgreSQL database connectivity functionality for the broader MCP platform. It connects to CloudSQL Postgres non-prod databases and enables AI code editors to:
-
-1. Understand all tables and schemas
-2. Run queries against the non-prod database
-3. List available databases and their aliases
-
----
-
-## Installation
-
-### Option 1: Install from PyPI
-
-```bash
-pip install nuuly-postgres-mcp-server
-```
-
-### Option 2: Install from Source
-
-1. Clone the repository:
-```bash
-git clone <REPO_URL>
-cd r15-mcp/mcp_servers/postgres-mcp
-```
-
-2. Install the package in development mode:
-```bash
-pip install -e .
-```
-
-## Local Development
-
-### Prerequisites
-- Python 3.8 or higher
-- pip package manager
-
-### Setup
-
-1. Clone the repository:
-```bash
-git clone <REPO_URL>
-cd r15-mcp/mcp_servers/postgres-mcp
-```
-
-2. Create and activate a virtual environment (optional but recommended):
-```bash
-python -m venv venv
-source venv/bin/activate  # On Windows: venv\Scripts\activate
-```
-
-3. Install development dependencies:
-```bash
-pip install -e .
-```
-
-4. Set up environment variables:
-```bash
-cp .env.example .env
-# Edit .env with your actual values
-```
-
-## Environment Variables
-
-The following environment variables can be set to customize the behavior of the MCP server:
-
-- `CLOUD_RUN_PROXY_URL`: URL of the Cloud Run DB Proxy (default: "https://postgres-mcp-toolbox-186512416539.us-east4.run.app")
-- `DB_PROXY_API_KEY`: API key for authenticating with the Cloud Run DB Proxy (required)
-- `LOG_LEVEL`: Logging level (default: INFO)
-
-## Usage
-
-### For Claude Desktop
-
-Add this configuration to your Claude Desktop settings:
-
-```json
-{
-  "Nuuly Postgres MCP": {
-    "command": "nuuly-postgres-mcp",
-    "env": {
-      "PYTHONUNBUFFERED": "1",
-      "CLOUD_RUN_PROXY_URL": "https://postgres-mcp-toolbox-186512416539.us-east4.run.app",
-      "DB_PROXY_API_KEY": "YOUR_API_KEY_HERE"
-    }
-  }
-}
-```
-
-### Command Line Usage
-
-```bash
-nuuly-postgres-mcp
-```
-
-## Deployment
-
-### As a GCP Cloud Function
-
-This MCP server is designed to be deployed as a GCP Cloud Function with the following parameters:
-
-- Project: `rental-dev`
-- Region: `us-east4`
-- Serverless VPC Connector: `rental-vpc-connector`
-- Entry point: `main.py`
-
-The function connects to CloudSQL PostgreSQL using private IP (10.171.208.52) and uses environment variables for DB credentials.
-
-```yaml
-environment_variables:
-  CLOUD_RUN_PROXY_URL: "https://postgres-mcp-toolbox-186512416539.us-east4.run.app"
-  DB_PROXY_API_KEY: "${DB_PROXY_API_KEY}"
-  LOG_LEVEL: "INFO"
-```
-
-### Building and Publishing the Package
-
-To build and publish the package to PyPI:
-
-```bash
-python -m build
-python -m twine upload dist/*
-```
-
-## Available Tools
-
-This MCP server provides the following tools to AI assistants:
-
-- `run_query`: Execute SQL queries against the database
-- `get_schema`: Get database schema information
-- `list_databases`: List available databases
-
-## Troubleshooting
-
-### Connection Issues with Claude Desktop
-
-If you experience connection issues with Claude Desktop (client transport closing), ensure that:
-
-1. The server is running with the correct URL for the Cloud Run DB Proxy
-2. The API key is correctly set and properly escaped in any curl commands (use single quotes)
-3. The server is properly handling heartbeat and shutdown messages
-4. The JSON-RPC initialization response includes `keepAlive: true` and `supportsHeartbeats: true`
-
-Example curl command to test the API:
-```bash
-curl -X GET "https://postgres-mcp-toolbox-186512416539.us-east4.run.app/databases" -H 'X-API-KEY: YOUR_API_KEY_HERE'
-```
-
-### Common Issues
-
-- **Missing API Key**: Ensure the `DB_PROXY_API_KEY` environment variable is set
-- **Permission Errors**: Verify that your API key has the necessary permissions
-- **Timeout Errors**: Check network latency or increase the timeout settings in the code
-- **Heartbeat Issues**: Ensure the MCP server properly implements heartbeat handlers

nuuly_postgres_mcp_server-1.0.0/src/nuuly_postgres_mcp_server.egg-info/PKG-INFO

@@ -1,179 +0,0 @@
-Metadata-Version: 2.4
-Name: nuuly-postgres-mcp-server
-Version: 1.0.0
-Summary: MCP server for accessing Nuuly PostgreSQL database resources
-Author-email: Nuuly Engineering <engineering@nuuly.com>
-License: Proprietary
-Project-URL: Homepage, https://github.com/urbn/r15-mcp
-Project-URL: Repository, https://github.com/urbn/r15-mcp
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: fastmcp>=2.2.1
-Requires-Dist: httpx>=0.24.0
-Requires-Dist: psycopg2-binary>=2.9.5
-
-# Nuuly Postgres MCP Server
-
-MCP server for accessing Nuuly PostgreSQL database resources through Claude Desktop and other AI assistants.
-
-## Contents
-- `src/nuuly_postgres_mcp_server/`: Package source code
-  - `__init__.py`: Package initialization
-  - `__main__.py`: Entry point for running as a module
-  - `server.py`: Main server implementation
-- `pyproject.toml`: Package configuration
-- `.env.example`: Example environment variables
-
-## Purpose
-This MCP server provides PostgreSQL database connectivity functionality for the broader MCP platform. It connects to CloudSQL Postgres non-prod databases and enables AI code editors to:
-
-1. Understand all tables and schemas
-2. Run queries against the non-prod database
-3. List available databases and their aliases
-
----
-
-## Installation
-
-### Option 1: Install from PyPI
-
-```bash
-pip install nuuly-postgres-mcp-server
-```
-
-### Option 2: Install from Source
-
-1. Clone the repository:
-```bash
-git clone <REPO_URL>
-cd r15-mcp/mcp_servers/postgres-mcp
-```
-
-2. Install the package in development mode:
-```bash
-pip install -e .
-```
-
-## Local Development
-
-### Prerequisites
-- Python 3.8 or higher
-- pip package manager
-
-### Setup
-
-1. Clone the repository:
-```bash
-git clone <REPO_URL>
-cd r15-mcp/mcp_servers/postgres-mcp
-```
-
-2. Create and activate a virtual environment (optional but recommended):
-```bash
-python -m venv venv
-source venv/bin/activate  # On Windows: venv\Scripts\activate
-```
-
-3. Install development dependencies:
-```bash
-pip install -e .
-```
-
-4. Set up environment variables:
-```bash
-cp .env.example .env
-# Edit .env with your actual values
-```
-
-## Environment Variables
-
-The following environment variables can be set to customize the behavior of the MCP server:
-
-- `CLOUD_RUN_PROXY_URL`: URL of the Cloud Run DB Proxy (default: "https://postgres-mcp-toolbox-186512416539.us-east4.run.app")
-- `DB_PROXY_API_KEY`: API key for authenticating with the Cloud Run DB Proxy (required)
-- `LOG_LEVEL`: Logging level (default: INFO)
-
-## Usage
-
-### For Claude Desktop
-
-Add this configuration to your Claude Desktop settings:
-
-```json
-{
-  "Nuuly Postgres MCP": {
-    "command": "nuuly-postgres-mcp",
-    "env": {
-      "PYTHONUNBUFFERED": "1",
-      "CLOUD_RUN_PROXY_URL": "https://postgres-mcp-toolbox-186512416539.us-east4.run.app",
-      "DB_PROXY_API_KEY": "YOUR_API_KEY_HERE"
-    }
-  }
-}
-```
-
-### Command Line Usage
-
-```bash
-nuuly-postgres-mcp
-```
-
-## Deployment
-
-### As a GCP Cloud Function
-
-This MCP server is designed to be deployed as a GCP Cloud Function with the following parameters:
-
-- Project: `rental-dev`
-- Region: `us-east4`
-- Serverless VPC Connector: `rental-vpc-connector`
-- Entry point: `main.py`
-
-The function connects to CloudSQL PostgreSQL using private IP (10.171.208.52) and uses environment variables for DB credentials.
-
-```yaml
-environment_variables:
-  CLOUD_RUN_PROXY_URL: "https://postgres-mcp-toolbox-186512416539.us-east4.run.app"
-  DB_PROXY_API_KEY: "${DB_PROXY_API_KEY}"
-  LOG_LEVEL: "INFO"
-```
-
-### Building and Publishing the Package
-
-To build and publish the package to PyPI:
-
-```bash
-python -m build
-python -m twine upload dist/*
-```
-
-## Available Tools
-
-This MCP server provides the following tools to AI assistants:
-
-- `run_query`: Execute SQL queries against the database
-- `get_schema`: Get database schema information
-- `list_databases`: List available databases
-
-## Troubleshooting
-
-### Connection Issues with Claude Desktop
-
-If you experience connection issues with Claude Desktop (client transport closing), ensure that:
-
-1. The server is running with the correct URL for the Cloud Run DB Proxy
-2. The API key is correctly set and properly escaped in any curl commands (use single quotes)
-3. The server is properly handling heartbeat and shutdown messages
-4. The JSON-RPC initialization response includes `keepAlive: true` and `supportsHeartbeats: true`
-
-Example curl command to test the API:
-```bash
-curl -X GET "https://postgres-mcp-toolbox-186512416539.us-east4.run.app/databases" -H 'X-API-KEY: YOUR_API_KEY_HERE'
-```
-
-### Common Issues
-
-- **Missing API Key**: Ensure the `DB_PROXY_API_KEY` environment variable is set
-- **Permission Errors**: Verify that your API key has the necessary permissions
-- **Timeout Errors**: Check network latency or increase the timeout settings in the code
-- **Heartbeat Issues**: Ensure the MCP server properly implements heartbeat handlers