iflow-mcp_simple-psql-mcp 1.0.0__tar.gz

iflow_mcp_simple_psql_mcp-1.0.0/.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+.idea 
+.DS_Store
+mcp_config.json

iflow_mcp_simple_psql_mcp-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Netanel Bollag
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

iflow_mcp_simple_psql_mcp-1.0.0/PKG-INFO

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_simple-psql-mcp
+Version: 1.0.0
+Summary: A PostgreSQL MCP server project
+Author-email: Netanel Bollag <nbollag@gmail.com>
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: aiohttp>=3.11.13
+Requires-Dist: mcp[cli]>=1.3.0
+Requires-Dist: pyyaml>=6.0.2
+Description-Content-Type: text/markdown
+
+# Simple PostgreSQL MCP Server
+
+This is a template project for those looking to build their own MCP servers. I designed it to be dead simple to understand and adapt - the code is straightforward with MCP docs attached so you can quickly get up to speed.
+
+## What is MCP?
+
+*TL;DR - It's a way to write plugins for AI*
+
+Model Context Protocol (MCP) is a standard way for LLMs to interact with external tools and data. In a nutshell:
+
+- **Tools** allow the LLM to execute commands (like running a database query)
+- **Resources** are data you can attach to conversations (like attaching a file to a prompt)
+- **Prompts** are templates that generate consistent LLM instructions
+
+## Features
+
+This PostgreSQL MCP server implements:
+
+1. **Tools**
+   - `execute_query` - Run SQL queries against your database
+   - `test_connection` - Verify the database connection is working
+
+2. **Resources**
+   - `db://tables` - List of all tables in the schema
+   - `db://tables/{table_name}` - Schema information for a specific table
+   - `db://schema` - Complete schema information for all tables in the database
+
+3. **Prompts**
+   - Query generation templates
+   - Analytical query builders
+   - Based on the templates in this repo
+
+## Prerequisites
+
+- Python 3.8+
+- [uv](https://github.com/astral-sh/uv) - Modern Python package manager and installer
+- npx (included with Node.js)
+- PostgreSQL database you can connect to
+
+## Quick Setup
+
+1. **Create a virtual environment and install dependencies:**
+   ```bash
+   # Create a virtual environment with uv
+   uv venv
+   
+   # Activate the virtual environment
+   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+   
+   # Install dependencies
+   uv pip install -r requirements.txt
+   ```
+
+2. **Run the server with the MCP Inspector:**
+   ```bash
+   # Replace with YOUR actual database credentials
+   npx @modelcontextprotocol/inspector uv --directory . run postgres -e DSN=postgresql://username:password@hostname:port/database -e SCHEMA=public
+   ```
+
+   > Note: If this is your first time running npx, you'll be prompted to approve the installation. Type 'y' to proceed.
+
+   After running this command, you'll see the MCP Inspector interface launched in your browser. You should see a message like:
+   ```
+   MCP Inspector is up and running at http://localhost:5173
+   ```
+
+   If the browser doesn't open automatically, copy and paste the URL into your browser. You should see something like this:
+   ![MCP Inspector Interface](inspector-screenshot.png)
+3. **Using the Inspector:**
+   - Click the "Connect" button in the interface (unless there's an error message in the console on the bottom left)
+   - Explore the "Tools", "Resources", and "Prompts" tabs to see available functionality
+   - Try clicking on listed commands or typing resource names to retrieve resources and prompts
+   - The interface allows you to test queries and see how the MCP server responds
+
+4. **Take a look at the official docs**
+
+   Official server developers guide: https://modelcontextprotocol.io/quickstart/server
+
+   More on the inspector: https://modelcontextprotocol.io/docs/tools/inspector
+
+## Connect Your AI Tool to the Server
+
+You can configure the MCP server for your AI assistant by creating an MCP configuration file:
+
+```json
+{
+   "mcpServers": {
+      "postgres": {
+         "command": "/path/to/uv",
+         "args": [
+            "--directory",
+            "/path/to/simple-psql-mcp",
+            "run",
+            "postgres"
+         ],
+         "env": {
+            "DSN": "postgresql://username:password@localhost:5432/my-db",
+            "SCHEMA": "public"
+         }
+      }
+   }
+}
+```
+
+Alternatively, you can generate this config file using the included script:
+
+```bash
+# Make the script executable
+chmod +x generate_mcp_config.sh
+
+# Run the configuration generator
+./generate_mcp_config.sh
+```
+
+When prompted, enter your PostgreSQL DSN and schema name.
+
+### How to use it
+
+You can now ask the LLM questions about your data in natural language:
+- "What are all the tables in my database?"
+- "Show me the top 5 users by creation date"
+- "Count addresses by state"
+
+For testing, Claude Desktop supports MCP natively and works with all features (tools, resources, and prompts) right out of the box.
+
+## Example Database (Optional)
+
+If you don't have a database ready or encounter connection issues, you can use the included example database:
+
+```bash
+# Make the script executable
+chmod +x example-db/create-db.sh
+
+# Run the database setup script
+./example-db/create-db.sh
+```
+
+This script creates a Docker container with a PostgreSQL database pre-populated with sample users and addresses tables. After running, you can connect using:
+
+```bash
+npx @modelcontextprotocol/inspector uv --directory . run postgres -e DSN=postgresql://postgres:postgres@localhost:5432/user_database -e SCHEMA=public
+```
+
+## Next Steps
+
+To extend this project with your own MCP servers:
+
+1. Create a new directory under `/src` (e.g., `/src/my-new-mcp`)
+2. Implement your MCP server following the PostgreSQL example
+3. Add your new MCP to `pyproject.toml`:
+
+```toml
+[project.scripts]
+postgres = "src.postgres:main"
+my-new-mcp = "src.my-new-mcp:main"
+```
+
+You can then run your new MCP with:
+
+```bash
+npx @modelcontextprotocol/inspector uv --directory . run my-new-mcp
+```
+
+## Documentation
+
+- MCP docs included for easy LLM development
+- Based on the approach at: https://modelcontextprotocol.io/tutorials/building-mcp-with-llms
+
+## Security
+
+This is an experimental project meant to empower developers to create their own MCP server. I did minimum to make sure it won't die immediately when you try it, but be careful - it's very easy to run SQL injections with this tool. The server will check if the query starts with SELECT, but beyond that nothing is guaranteed. TL;DR - don't run in production unless you're the founder and there are no paying clients.
+
+## License
+
+MIT

iflow_mcp_simple_psql_mcp-1.0.0/README.md

@@ -0,0 +1,175 @@
+# Simple PostgreSQL MCP Server
+
+This is a template project for those looking to build their own MCP servers. I designed it to be dead simple to understand and adapt - the code is straightforward with MCP docs attached so you can quickly get up to speed.
+
+## What is MCP?
+
+*TL;DR - It's a way to write plugins for AI*
+
+Model Context Protocol (MCP) is a standard way for LLMs to interact with external tools and data. In a nutshell:
+
+- **Tools** allow the LLM to execute commands (like running a database query)
+- **Resources** are data you can attach to conversations (like attaching a file to a prompt)
+- **Prompts** are templates that generate consistent LLM instructions
+
+## Features
+
+This PostgreSQL MCP server implements:
+
+1. **Tools**
+   - `execute_query` - Run SQL queries against your database
+   - `test_connection` - Verify the database connection is working
+
+2. **Resources**
+   - `db://tables` - List of all tables in the schema
+   - `db://tables/{table_name}` - Schema information for a specific table
+   - `db://schema` - Complete schema information for all tables in the database
+
+3. **Prompts**
+   - Query generation templates
+   - Analytical query builders
+   - Based on the templates in this repo
+
+## Prerequisites
+
+- Python 3.8+
+- [uv](https://github.com/astral-sh/uv) - Modern Python package manager and installer
+- npx (included with Node.js)
+- PostgreSQL database you can connect to
+
+## Quick Setup
+
+1. **Create a virtual environment and install dependencies:**
+   ```bash
+   # Create a virtual environment with uv
+   uv venv
+   
+   # Activate the virtual environment
+   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+   
+   # Install dependencies
+   uv pip install -r requirements.txt
+   ```
+
+2. **Run the server with the MCP Inspector:**
+   ```bash
+   # Replace with YOUR actual database credentials
+   npx @modelcontextprotocol/inspector uv --directory . run postgres -e DSN=postgresql://username:password@hostname:port/database -e SCHEMA=public
+   ```
+
+   > Note: If this is your first time running npx, you'll be prompted to approve the installation. Type 'y' to proceed.
+
+   After running this command, you'll see the MCP Inspector interface launched in your browser. You should see a message like:
+   ```
+   MCP Inspector is up and running at http://localhost:5173
+   ```
+
+   If the browser doesn't open automatically, copy and paste the URL into your browser. You should see something like this:
+   ![MCP Inspector Interface](inspector-screenshot.png)
+3. **Using the Inspector:**
+   - Click the "Connect" button in the interface (unless there's an error message in the console on the bottom left)
+   - Explore the "Tools", "Resources", and "Prompts" tabs to see available functionality
+   - Try clicking on listed commands or typing resource names to retrieve resources and prompts
+   - The interface allows you to test queries and see how the MCP server responds
+
+4. **Take a look at the official docs**
+
+   Official server developers guide: https://modelcontextprotocol.io/quickstart/server
+
+   More on the inspector: https://modelcontextprotocol.io/docs/tools/inspector
+
+## Connect Your AI Tool to the Server
+
+You can configure the MCP server for your AI assistant by creating an MCP configuration file:
+
+```json
+{
+   "mcpServers": {
+      "postgres": {
+         "command": "/path/to/uv",
+         "args": [
+            "--directory",
+            "/path/to/simple-psql-mcp",
+            "run",
+            "postgres"
+         ],
+         "env": {
+            "DSN": "postgresql://username:password@localhost:5432/my-db",
+            "SCHEMA": "public"
+         }
+      }
+   }
+}
+```
+
+Alternatively, you can generate this config file using the included script:
+
+```bash
+# Make the script executable
+chmod +x generate_mcp_config.sh
+
+# Run the configuration generator
+./generate_mcp_config.sh
+```
+
+When prompted, enter your PostgreSQL DSN and schema name.
+
+### How to use it
+
+You can now ask the LLM questions about your data in natural language:
+- "What are all the tables in my database?"
+- "Show me the top 5 users by creation date"
+- "Count addresses by state"
+
+For testing, Claude Desktop supports MCP natively and works with all features (tools, resources, and prompts) right out of the box.
+
+## Example Database (Optional)
+
+If you don't have a database ready or encounter connection issues, you can use the included example database:
+
+```bash
+# Make the script executable
+chmod +x example-db/create-db.sh
+
+# Run the database setup script
+./example-db/create-db.sh
+```
+
+This script creates a Docker container with a PostgreSQL database pre-populated with sample users and addresses tables. After running, you can connect using:
+
+```bash
+npx @modelcontextprotocol/inspector uv --directory . run postgres -e DSN=postgresql://postgres:postgres@localhost:5432/user_database -e SCHEMA=public
+```
+
+## Next Steps
+
+To extend this project with your own MCP servers:
+
+1. Create a new directory under `/src` (e.g., `/src/my-new-mcp`)
+2. Implement your MCP server following the PostgreSQL example
+3. Add your new MCP to `pyproject.toml`:
+
+```toml
+[project.scripts]
+postgres = "src.postgres:main"
+my-new-mcp = "src.my-new-mcp:main"
+```
+
+You can then run your new MCP with:
+
+```bash
+npx @modelcontextprotocol/inspector uv --directory . run my-new-mcp
+```
+
+## Documentation
+
+- MCP docs included for easy LLM development
+- Based on the approach at: https://modelcontextprotocol.io/tutorials/building-mcp-with-llms
+
+## Security
+
+This is an experimental project meant to empower developers to create their own MCP server. I did minimum to make sure it won't die immediately when you try it, but be careful - it's very easy to run SQL injections with this tool. The server will check if the query starts with SELECT, but beyond that nothing is guaranteed. TL;DR - don't run in production unless you're the founder and there are no paying clients.
+
+## License
+
+MIT

iflow_mcp_simple_psql_mcp-1.0.0/example-db/create-db.sh

@@ -0,0 +1,98 @@
+#!/bin/bash
+
+# Script to set up PostgreSQL container and initialize database with users and addresses
+
+# Define container name and credentials
+CONTAINER_NAME="postgres_local"
+DB_NAME="user_database"
+DB_USER="postgres"
+DB_PASSWORD="postgres"
+DB_PORT="5432"
+
+# Stop and remove container if it already exists
+echo "Stopping and removing existing container if it exists..."
+docker stop $CONTAINER_NAME 2>/dev/null
+docker rm $CONTAINER_NAME 2>/dev/null
+
+# Run PostgreSQL container
+echo "Starting PostgreSQL container..."
+docker run --name $CONTAINER_NAME \
+  -e POSTGRES_PASSWORD=$DB_PASSWORD \
+  -e POSTGRES_DB=$DB_NAME \
+  -p $DB_PORT:5432 \
+  -d postgres:14
+
+# Wait for PostgreSQL to initialize
+echo "Waiting for PostgreSQL to initialize..."
+sleep 10
+
+# Create SQL script for database setup
+cat > init_db.sql << EOF
+-- Create addresses table
+CREATE TABLE addresses (
+  address_id SERIAL PRIMARY KEY,
+  street_address VARCHAR(100) NOT NULL,
+  city VARCHAR(50) NOT NULL,
+  state VARCHAR(50) NOT NULL,
+  postal_code VARCHAR(20) NOT NULL,
+  country VARCHAR(50) NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Create users table
+CREATE TABLE users (
+  user_id SERIAL PRIMARY KEY,
+  first_name VARCHAR(50) NOT NULL,
+  last_name VARCHAR(50) NOT NULL,
+  email VARCHAR(100) UNIQUE NOT NULL,
+  phone VARCHAR(20),
+  address_id INTEGER REFERENCES addresses(address_id),
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Insert 10 addresses
+INSERT INTO addresses (street_address, city, state, postal_code, country) VALUES
+  ('123 Oak Street', 'New York', 'NY', '10001', 'USA'),
+  ('456 Pine Avenue', 'Los Angeles', 'CA', '90001', 'USA'),
+  ('789 Maple Road', 'Chicago', 'IL', '60007', 'USA'),
+  ('321 Cedar Lane', 'Houston', 'TX', '77001', 'USA'),
+  ('654 Birch Boulevard', 'Philadelphia', 'PA', '19019', 'USA'),
+  ('987 Spruce Court', 'Phoenix', 'AZ', '85001', 'USA'),
+  ('135 Willow Way', 'San Antonio', 'TX', '78201', 'USA'),
+  ('246 Redwood Drive', 'San Diego', 'CA', '92101', 'USA'),
+  ('579 Elm Street', 'Dallas', 'TX', '75201', 'USA'),
+  ('864 Aspen Circle', 'San Jose', 'CA', '95101', 'USA');
+
+-- Insert 10 users linked to addresses
+INSERT INTO users (first_name, last_name, email, phone, address_id) VALUES
+  ('John', 'Doe', 'john.doe@example.com', '212-555-1234', 1),
+  ('Jane', 'Smith', 'jane.smith@example.com', '310-555-2345', 2),
+  ('Michael', 'Johnson', 'michael.johnson@example.com', '312-555-3456', 3),
+  ('Emily', 'Williams', 'emily.williams@example.com', '713-555-4567', 4),
+  ('Robert', 'Brown', 'robert.brown@example.com', '267-555-5678', 5),
+  ('Sarah', 'Miller', 'sarah.miller@example.com', '602-555-6789', 6),
+  ('David', 'Wilson', 'david.wilson@example.com', '210-555-7890', 7),
+  ('Jessica', 'Taylor', 'jessica.taylor@example.com', '619-555-8901', 8),
+  ('Christopher', 'Anderson', 'christopher.anderson@example.com', '214-555-9012', 9),
+  ('Amanda', 'Martinez', 'amanda.martinez@example.com', '408-555-0123', 10);
+EOF
+
+# Execute SQL script
+echo "Initializing database with sample data..."
+docker exec -i $CONTAINER_NAME psql -U $DB_USER -d $DB_NAME < init_db.sql
+
+# Verify data was inserted
+echo "Verifying data insertion..."
+docker exec -i $CONTAINER_NAME psql -U $DB_USER -d $DB_NAME -c "SELECT COUNT(*) FROM users;"
+docker exec -i $CONTAINER_NAME psql -U $DB_USER -d $DB_NAME -c "SELECT COUNT(*) FROM addresses;"
+
+echo "Database setup complete!"
+echo "PostgreSQL is running on localhost:$DB_PORT"
+echo "Database: $DB_NAME"
+echo "Username: $DB_USER"
+echo "Password: $DB_PASSWORD"
+
+# Display connection command example
+echo ""
+echo "To connect directly to the PostgreSQL client, run:"
+echo "docker exec -it $CONTAINER_NAME psql -U $DB_USER -d $DB_NAME"

iflow_mcp_simple_psql_mcp-1.0.0/example-db/seed_db.sql

@@ -0,0 +1,140 @@
+-- PostgreSQL seed file to generate 1000 additional users and addresses
+-- This builds on the existing schema with users and addresses tables
+
+-- Function to generate random strings for names, streets, etc.
+CREATE OR REPLACE FUNCTION random_string(length INTEGER) RETURNS TEXT AS
+$$
+DECLARE
+  chars TEXT := 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+  result TEXT := '';
+  i INTEGER := 0;
+BEGIN
+  FOR i IN 1..length LOOP
+    result := result || substr(chars, floor(random() * length(chars) + 1)::INTEGER, 1);
+  END LOOP;
+  RETURN result;
+END;
+$$ LANGUAGE plpgsql;
+
+-- Function to generate random phone numbers
+CREATE OR REPLACE FUNCTION random_phone() RETURNS TEXT AS
+$$
+BEGIN
+  RETURN 
+    LPAD(floor(random() * 900 + 100)::TEXT, 3, '0') || '-' || 
+    LPAD(floor(random() * 900 + 100)::TEXT, 3, '0') || '-' || 
+    LPAD(floor(random() * 9000 + 1000)::TEXT, 4, '0');
+END;
+$$ LANGUAGE plpgsql;
+
+-- Array of common street types
+CREATE TEMP TABLE street_types AS
+SELECT unnest(ARRAY['Street', 'Avenue', 'Boulevard', 'Road', 'Lane', 'Drive', 'Way', 'Court', 'Plaza', 'Terrace']) AS name;
+
+-- Array of common first names
+CREATE TEMP TABLE first_names AS
+SELECT unnest(ARRAY[
+  'James', 'Mary', 'John', 'Patricia', 'Robert', 'Jennifer', 'Michael', 'Linda', 'William', 'Elizabeth',
+  'David', 'Susan', 'Richard', 'Jessica', 'Joseph', 'Sarah', 'Thomas', 'Karen', 'Charles', 'Nancy',
+  'Christopher', 'Lisa', 'Daniel', 'Margaret', 'Matthew', 'Betty', 'Anthony', 'Sandra', 'Mark', 'Ashley',
+  'Donald', 'Kimberly', 'Steven', 'Emily', 'Paul', 'Donna', 'Andrew', 'Michelle', 'Joshua', 'Dorothy',
+  'Kenneth', 'Carol', 'Kevin', 'Amanda', 'Brian', 'Melissa', 'George', 'Deborah', 'Edward', 'Stephanie'
+]) AS name;
+
+-- Array of common last names
+CREATE TEMP TABLE last_names AS
+SELECT unnest(ARRAY[
+  'Smith', 'Johnson', 'Williams', 'Jones', 'Brown', 'Davis', 'Miller', 'Wilson', 'Moore', 'Taylor',
+  'Anderson', 'Thomas', 'Jackson', 'White', 'Harris', 'Martin', 'Thompson', 'Garcia', 'Martinez', 'Robinson',
+  'Clark', 'Rodriguez', 'Lewis', 'Lee', 'Walker', 'Hall', 'Allen', 'Young', 'Hernandez', 'King',
+  'Wright', 'Lopez', 'Hill', 'Scott', 'Green', 'Adams', 'Baker', 'Gonzalez', 'Nelson', 'Carter',
+  'Mitchell', 'Perez', 'Roberts', 'Turner', 'Phillips', 'Campbell', 'Parker', 'Evans', 'Edwards', 'Collins'
+]) AS name;
+
+-- Array of cities
+CREATE TEMP TABLE cities AS
+SELECT unnest(ARRAY[
+  'New York', 'Los Angeles', 'Chicago', 'Houston', 'Phoenix', 'Philadelphia', 'San Antonio', 'San Diego', 
+  'Dallas', 'San Jose', 'Austin', 'Jacksonville', 'Fort Worth', 'Columbus', 'Indianapolis', 'Charlotte', 
+  'San Francisco', 'Seattle', 'Denver', 'Washington', 'Boston', 'El Paso', 'Nashville', 'Detroit', 'Portland'
+]) AS city,
+unnest(ARRAY[
+  'NY', 'CA', 'IL', 'TX', 'AZ', 'PA', 'TX', 'CA', 
+  'TX', 'CA', 'TX', 'FL', 'TX', 'OH', 'IN', 'NC', 
+  'CA', 'WA', 'CO', 'DC', 'MA', 'TX', 'TN', 'MI', 'OR'
+]) AS state;
+
+-- Begin transaction
+BEGIN;
+
+-- Get the current max IDs to know where to start
+DO $$
+DECLARE
+  max_address_id INTEGER;
+  max_user_id INTEGER;
+  address_id INTEGER;
+  first_name TEXT;
+  last_name TEXT;
+  street_num INTEGER;
+  street_name TEXT;
+  street_type TEXT;
+  city_rec RECORD;
+  postal_code TEXT;
+  email TEXT;
+  i INTEGER;
+BEGIN
+  -- Get max IDs
+  SELECT COALESCE(MAX(addresses.address_id), 0) INTO max_address_id FROM addresses;
+  SELECT COALESCE(MAX(user_id), 0) INTO max_user_id FROM users;
+  
+  -- Generate 1000 new records
+  FOR i IN 1..1000 LOOP
+    -- Generate address data
+    address_id := max_address_id + i;
+    street_num := floor(random() * 9900 + 100)::INTEGER;
+    street_name := (SELECT name FROM first_names ORDER BY random() LIMIT 1);
+    street_type := (SELECT name FROM street_types ORDER BY random() LIMIT 1);
+    SELECT * INTO city_rec FROM cities ORDER BY random() LIMIT 1;
+    postal_code := LPAD(floor(random() * 90000 + 10000)::TEXT, 5, '0');
+    
+    -- Insert address
+    INSERT INTO addresses (street_address, city, state, postal_code, country)
+    VALUES (
+      street_num || ' ' || street_name || ' ' || street_type,
+      city_rec.city,
+      city_rec.state,
+      postal_code,
+      'USA'
+    );
+    
+    -- Generate user data
+    first_name := (SELECT name FROM first_names ORDER BY random() LIMIT 1);
+    last_name := (SELECT name FROM last_names ORDER BY random() LIMIT 1);
+    email := lower(first_name) || '.' || lower(last_name) || i || '@example.com';
+    
+    -- Insert user with reference to the new address
+    INSERT INTO users (first_name, last_name, email, phone, address_id)
+    VALUES (
+      first_name,
+      last_name,
+      email,
+      random_phone(),
+      address_id
+    );
+  END LOOP;
+END $$;
+
+-- Verify the data was inserted
+SELECT COUNT(*) AS total_addresses FROM addresses;
+SELECT COUNT(*) AS total_users FROM users;
+
+-- Clean up temporary functions and tables
+DROP FUNCTION IF EXISTS random_string;
+DROP FUNCTION IF EXISTS random_phone;
+DROP TABLE IF EXISTS street_types;
+DROP TABLE IF EXISTS first_names;
+DROP TABLE IF EXISTS last_names;
+DROP TABLE IF EXISTS cities;
+
+COMMIT;
+

iflow_mcp_simple_psql_mcp-1.0.0/generate_mcp_config.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+
+# Find the uv executable path
+UV_PATH=$(which uv)
+if [ -z "$UV_PATH" ]; then
+  echo "Error: 'uv' executable not found in PATH"
+  exit 1
+fi
+
+# Get current working directory
+CURRENT_DIR=$(pwd)
+
+# Prompt for DSN and schema
+read -p "Enter PostgreSQL DSN (e.g., postgresql://postgres:postgres@localhost:5432/user_database): " DSN
+read -p "Enter schema name (press Enter for public): " DB_SCHEMA
+DB_SCHEMA=${DB_SCHEMA:-public}
+
+# Create the JSON configuration
+cat > mcp_config.json << EOF
+{
+  "mcpServers": {
+    "postgres": {
+      "command": "${UV_PATH}",
+      "args": [
+        "--directory",
+        "${CURRENT_DIR}",
+        "run",
+        "postgres"
+      ],
+      "env": {
+        "DSN": "${DSN}",
+        "SCHEMA": "${DB_SCHEMA}"
+      }
+    }
+  }
+}
+EOF
+
+cat mcp_config.json