Skip to main content
Glama
prashil1996

bank-postgres-mcp

by prashil1996

bank-postgres-mcp

HTTP MCP сервер, который читает и записывает данные в базу данных PostgreSQL (bankdb). Развернут и доступен по адресу: https://armored-backspace-angles.ngrok-free.dev/mcp

Конечные точки

Путь

Метод

Назначение

/mcp

POST

MCP Streamable HTTP конечная точка

/health

GET

Проверка работоспособности

Related MCP server: db-mcp

Инструменты

Инструменты чтения (запросы напрямую к bankdb)

Инструмент

Описание

list_customers

Список всех клиентов в базе данных

get_customer_by_id

Получить профиль клиента + все счета по customer_id

get_customer_by_account

Найти клиента и счет по номеру счета (например, DB5194542004)

get_transactions

Получить последние транзакции по account_id или account_number

Инструменты записи (вставка или обновление в таблицы дампа MCP)

Инструмент

Действие

dump_customer_data

Вставить или обновить полученную запись клиента в таблицу customers

dump_created_customer

Вставить только что созданного клиента в таблицу customers

dump_bank_branch

Вставить или обновить запись отделения банка в таблицу bank_branches

Таблицы автоматически создаются при первом использовании.


Настройка

1. Предварительные требования

  • Node.js ≥ 18

  • PostgreSQL, работающий локально

2. Установка и сборка

cd bank-postgres-mcp
npm install
npm run build

3. Настройка окружения

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

Предоставленные учетные данные:

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

4. Запуск сервера

# 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

Сервер запускается на http://localhost:3100 по умолчанию. Переопределите с помощью PORT=XXXX.

5. Проверка

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

Регистрация в watsonx Orchestrate

В Orchestrate добавьте новую интеграцию инструмента MCP Server:

Поле

Значение

Транспорт

Streamable HTTP

URL

http://localhost:3100/mcp

Если Orchestrate запущен удаленно (не на вашем ноутбуке), откройте сервер через туннель:

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

Регистрация в Bob (.bob/mcp.json)

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

Схема базы данных

customers

Столбец

Тип

Примечания

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

строка1, строка2, город, штат, почтовый_индекс, страна

account_type

TEXT

kyc_status

TEXT

available_balance

NUMERIC

credit_score

INT

nominee

TEXT

source

TEXT

fetch или create

inserted_at

TIMESTAMPTZ

авто

updated_at

TIMESTAMPTZ

авто

bank_branches

Столбец

Тип

Примечания

ifsc

TEXT PK

branch_name

TEXT

bank_name

TEXT

city

TEXT

state

TEXT

services

TEXT[]

inserted_at

TIMESTAMPTZ

авто

updated_at

TIMESTAMPTZ

авто

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