Skip to main content
Glama
prashil1996

bank-postgres-mcp

by prashil1996

bank-postgres-mcp

HTTP-MCP-Server, der aus einer PostgreSQL-Datenbank (bankdb) liest und in diese schreibt. Bereitgestellt und erreichbar unter: https://armored-backspace-angles.ngrok-free.dev/mcp

Endpunkte

Pfad

Methode

Zweck

/mcp

POST

MCP Streamable HTTP-Endpunkt

/health

GET

Lebendigkeitsprüfung

Related MCP server: db-mcp

Tools

Lese-Tools (direkte Abfrage von bankdb)

Tool

Beschreibung

list_customers

Alle Kunden in der Datenbank auflisten

get_customer_by_id

Kundenprofil + alle Konten anhand der customer_id abrufen

get_customer_by_account

Kunden + Konto anhand der Kontonummer (z. B. DB5194542004) nachschlagen

get_transactions

Aktuelle Transaktionen anhand der account_id oder account_number abrufen

Schreib-Tools (Upsert in MCP-Dump-Tabellen)

Tool

Aktion

dump_customer_data

Upsert eines abgerufenen Kundendatensatzes in customers

dump_created_customer

Einfügen eines neu erstellten Kunden in customers

dump_bank_branch

Upsert eines Bankfilialdatensatzes in bank_branches

Tabellen werden bei der ersten Nutzung automatisch erstellt.


Einrichtung

1. Voraussetzungen

  • Node.js ≥ 18

  • PostgreSQL läuft lokal

2. Installieren und erstellen

cd bank-postgres-mcp
npm install
npm run build

3. Umgebung konfigurieren

cp env.example .env
# .env is gitignored — edit credentials there

Bereitgestellte Anmeldedaten:

DATABASE_URL=postgresql://bankuser:bankpassword@localhost:5432/bankdb
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_DB=bankdb
POSTGRES_USER=bankuser
POSTGRES_PASSWORD=bankpassword

4. Server starten

# Export env vars, then start
export DATABASE_URL=postgresql://bankuser:bankpassword@localhost:5432/bankdb
node build/index.js

# Or with all vars:
export POSTGRES_HOST=localhost POSTGRES_PORT=5432 POSTGRES_DB=bankdb \
       POSTGRES_USER=bankuser POSTGRES_PASSWORD=bankpassword
node build/index.js

Der Server startet standardmäßig auf http://localhost:3100. Überschreiben mit PORT=XXXX.

5. Überprüfen

curl http://localhost:3100/health
# → {"status":"ok","server":"bank-postgres-mcp","version":"1.0.0"}

Registrierung in watsonx Orchestrate

Fügen Sie in Orchestrate eine neue MCP-Server-Tool-Integration hinzu:

Feld

Wert

Transport

Streamable HTTP

URL

http://localhost:3100/mcp

Wenn Orchestrate remote (nicht auf Ihrem Laptop) ausgeführt wird, machen Sie den Server über einen Tunnel zugänglich:

npx localtunnel --port 3100
# Use the returned https URL instead of localhost

Registrierung in Bob (.bob/mcp.json)

{
  "mcpServers": {
    "bank-postgres-mcp": {
      "url": "http://localhost:3100/mcp"
    }
  }
}

Datenbankschema

customers

Spalte

Typ

Hinweise

customer_id

TEXT PK

full_name

TEXT

date_of_birth

TEXT

phone

TEXT

email

TEXT

pan

TEXT

PII

aadhaar

TEXT

PII

account_number

TEXT

PII

ifsc

TEXT

address_*

TEXT

line1, line2, city, state, postal_code, country

account_type

TEXT

kyc_status

TEXT

available_balance

NUMERIC

credit_score

INT

nominee

TEXT

source

TEXT

fetch oder create

inserted_at

TIMESTAMPTZ

automatisch

updated_at

TIMESTAMPTZ

automatisch

bank_branches

Spalte

Typ

Hinweise

ifsc

TEXT PK

branch_name

TEXT

bank_name

TEXT

city

TEXT

state

TEXT

services

TEXT[]

inserted_at

TIMESTAMPTZ

automatisch

updated_at

TIMESTAMPTZ

automatisch

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    A minimal banking system MCP server that allows account management, deposits, withdrawals, balance inquiries, and transaction history via REST endpoints.
    -
  • A
    license
    A
    quality
    D
    maintenance
    A lightweight MCP server for relational databases, enabling dynamic connections to PostgreSQL and MySQL, SQL execution, and transaction control.
    7
    52 npm
    1
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Full-featured MCP server that exposes 36 tools for interacting with PostgreSQL databases, covering schema introspection, query execution, data exploration, performance monitoring, security auditing, and maintenance.
    36
    8 npm
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for PostgreSQL that enables Cursor and other MCP clients to execute SQL queries, list tables, and explore database schemas via HTTP.
    1,293 npm
    MIT