PostgreSQL MCP Server: Nói Chuyện Với Database Bằng Natural Language

AI agent có thể viết SQL hoàn hảo. Nhưng nó không connect được database. Bạn copy-paste query, nó phân tích, bạn copy-paste kết quả lại. Back-and-forth này tốn thời gian và ngắt flow.

PostgreSQL MCP Server giải quyết bằng cách cho agent direct, read-only database access. Nó có thể inspect schemas, chạy SELECT queries, phân tích data patterns, và suggest optimizations — tất cả qua natural language.

Cài Đặt#

CrystalDBA/postgres-mcp (Docker, Khuyến nghị)#

1
claude mcp add postgres \
2
  --command docker \
3
  --args "run -i --rm -e DATABASE_URL postgres-mcp" \
4
  --env DATABASE_URL="postgresql://user:password@localhost:5432/mydb"

Official MCP Server (npx, không Docker)#

1
claude mcp add postgres \
2
  --env DATABASE_URL="postgresql://user:password@localhost:5432/mydb" \
3
  -- npx -y @modelcontextprotocol/server-postgres

Neon (Serverless PostgreSQL)#

1
claude mcp add neon \
2
  --transport http \
3
  neon https://mcp.neon.tech/YOUR_NEON_API_KEY/v1/mcp

Tools Overview#

Tool	Chức năng	Ví dụ
query	Chạy SELECT	”Top 10 khách hàng theo doanh thu”
list_tables	List tất cả tables	”Có tables nào trong public schema?“
describe_table	Show columns, types, constraints	”Mô tả bảng orders”
get_schema	Full database schema	”Cho xem toàn bộ cấu trúc database”

Security: Read-Only User#

Đây là security consideration quan trọng nhất của database MCP:

Tạo read-only user trước#

1
CREATE USER mcp_reader WITH PASSWORD 'secure' LOGIN;
2
GRANT pg_read_all_data TO mcp_reader;
3
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO mcp_reader;

Không bao giờ dùng admin user#

1
# ❌ Sai — full write access
2
DATABASE_URL="postgresql://admin:super_secret@prod-db:5432/production"
3

4
# ✅ Đúng — read-only
5
DATABASE_URL="postgresql://mcp_reader:secure@localhost:5432/mydb?sslmode=require"

Measure	Why
Read-only user	Ngăn accidental writes, truncation, drops
SSL mode required	Mã hóa data in transit
Statement timeout	`SET statement_timeout = '30s'` — ngăn runaway queries

Token Cost Warning#

PostgreSQL MCP có vấn đề: token explosion từ large schemas.

Scenario	Token Cost
Query 3-4 joins	500 - 2,000 tokens
List 20 tables	1,000 - 3,000 tokens
Describe wide table (30+ columns)	3,000 - 8,000 tokens
Full schema (50+ tables)	10,000 - 50,000+ tokens ⚠️

Mitigations: Chỉ describe tables cần thiết, dùng describe_table orders thay vì get_schema, connect tới views-only schema nếu có thể.

Workflows Thực Tế#

Workflow 1: Ad-Hoc Analytics#

1
$ claude "MRR trend 6 tháng gần đây?"
2

3
Agent:
4
  1. Inspect: subscriptions, payments tables
5
  2. Chạy query với date_trunc, GROUP BY
6
  3. Trả về: trend 6 tháng kèm % tăng trưởng

Workflow 2: Schema Understanding#

1
$ claude "Cần xây API endpoint cho user profiles. Database có gì?"
2

3
Agent:
4
  1. List_tables → users, profiles, addresses
5
  2. Describe từng table
6
  3. "Data model dùng 1:1 giữa users và profiles.
7
     Tôi sẽ gen endpoint với joins chính xác."

Workflow 3: Data Validation#

1
$ claude "Vừa chạy schema migration. Verify data integrity."
2

3
Agent:
4
  So sánh row counts, check foreign keys, validate null percentages
5
  → "Migration clean. 15,342 users migrated. 0 orphaned profiles."

Tổng Kết#

PostgreSQL MCP Server biến database từ tool riêng thành extension của bộ não AI agent. Nó inspect schemas, phân tích data, validate migrations, suggest optimizations — qua natural language.

Nguyên tắc vàng: tạo read-only database user riêng cho MCP. Agent phân tích được mọi thứ nhưng không sửa được gì.

Series: Practical MCP Servers for Developers — 2026 Edition. Day 5 of 6.