Skip to main content
Glama
prashil1996

bank-postgres-mcp

by prashil1996

bank-postgres-mcp

HTTP MCPサーバーで、PostgreSQLデータベース(bankdb)からの読み取りおよび書き込みを行います。 デプロイ済みで、以下のURLからアクセス可能です: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ダンプテーブルにupsert)

ツール

アクション

dump_customer_data

取得した顧客レコードを customers テーブルにupsert

dump_created_customer

新しく作成した顧客を customers テーブルに挿入

dump_bank_branch

銀行支店レコードを bank_branches テーブルにupsert

テーブルは初回使用時に自動生成されます。


セットアップ

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

個人情報

aadhaar

TEXT

個人情報

account_number

TEXT

個人情報

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 または 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