pgbot: 사람과 에이전트를 위한 5.9 MB의 읽기 전용 Postgres 도구

연결 방법

같은 장소로 가는 두 가지 경로가 있습니다. 와이어를 통해 직접 연결하거나, 네트워크를 벗어나지 않는 데이터베이스 옆에서 에이전트를 실행하는 것입니다.

pgbot.dev │ ┌───────────────────┴───────────────────┐ │ │ Direct PostgreSQL access pgBot agent │ │ Supabase · Neon · RDS Docker · Kubernetes PlanetScale · public DBs Private servers · VPC │ │ └───────────────────┬───────────────────┘ ▼ PostgreSQL

기능

모든 PostgreSQL 데이터베이스에 연결하여 AI 기반 설명과 함께 성능, 쿼리, 상태(health), 스키마 및 변경 사항을 확인할 수 있습니다.

• 연결, 잠금(locks), 트랜잭션, 캐시 적중률(cache hit ratio), 복제(replication), WAL, 그리고 전반적인 데이터베이스 상태를 모니터링합니다.
• PostgreSQL 통계를 사용하여 느린 쿼리, 회귀(regressions), 처리량(throughput), 쿼리 지연 시간(query latency), 그리고 비용이 많이 드는 SQL을 추적합니다.
• 테이블 성장, 인덱스 사용률, 사용하지 않는 인덱스(unused indexes), 누락된 인덱스(missing indexes), vacuum 활동 및 스토리지 패턴을 분석합니다.
• 일상적인 영어로 pgBot에 질문하고 실제 데이터베이스 신호를 기반으로 요약, 설명 및 권장 사항을 받습니다.
• 공개 데이터베이스에 직접 연결하거나, Docker, Kubernetes, 내부 서버와 같은 사설 환경에는 pgBot Agent를 사용합니다.
• 읽기 전용 접근 방식이며, 오픈 소스 에이전트이고, 데이터베이스를 공개적으로 노출하지 않고도 사설 배포를 지원합니다.

MCP — pgbot을 에이전트 도구로 사용하기

pgbot mcp는 stdio에서 Model Context Protocol(MCP)을 사용하여 AI 에이전트가 pgbot을 읽기 전용 도구로 호출할 수 있게 합니다. 이는 결정론적 도구만 노출합니다 — inspect (JSON 형식의 전체 결과)와 unused_indexes — 그리고 연결된 모델이 설명하는 역할을 수행하게 합니다. Gemini 키는 필요하지 않습니다: 에이전트는 CLI가 계산한 것과 동일한 결과를 바탕으로 추론합니다.

{ "mcpServers": { "pgbot": { "command": "pgbot", "args": ["mcp"], "env": { "DATABASE_URL": "postgres://pgbot_ro@host:5432/db" } } }

설계상 읽기 전용(Read-only by construction)

DATABASE_URL이 설정되면, 에이전트는 인수를 없이 inspect를 호출하거나, 호출마다 연결 문자열을 전달하여 여러 데이터베이스에 접근할 수 있습니다. pgbot은 절대 쓰기를 하지 않으므로, 에이전트가 손상시킬 수 있는 부분이 없습니다.

도구, 프롬프트 및 리소스

또한 진단(diagnose) 프롬프트를 노출하며, 이는 한 번의 클릭으로 '검사하고 우선순위가 지정된 진단을 제공'하는 워크플로우를 수행합니다. 또한 pgbot://baselines라는 리소스를 통해 pgbot이 로컬 이력을 가지고 있는 데이터베이스 목록을 확인할 수 있습니다.

핵심 기능

• +PostgreSQL 상태 모니터링
• +쿼리 성능 분석
• +느린 쿼리 및 회귀 감지
• +잠금(Locks) 및 차단(blocking) 쿼리 통찰력
• +테이블 및 인덱스 분석
• +Vacuum 및 autovacuum 가시성
• +데이터베이스 성장 추적
• +AI 근본 원인 분석
• +AI 기반 추천
• +직접 연결 또는 에이전트 기반 비공개 액세스

pgBot을 사용해야 하는 이유

단순한 지표가 아닙니다. 맥락(Context)입니다.

pgBot은 무엇이 변경되었고, 그것이 왜 중요한지 이해하는 데 도움을 줍니다.

단순한 대시보드가 아닙니다. 설명입니다.

일상적인 영어로 질문하고 실행 가능한 답변을 얻으세요.

호스팅된 Postgres에만 국한되지 않습니다.

Supabase, Neon, RDS, Docker, Kubernetes 및 사설 서버와 함께 pgBot을 사용하세요.

단순한 관측 가능성(observability)이 아닙니다. AI DBA입니다.

문제를 더 빨리 찾고 더 나은 결정을 내리는 데 도움을 주는 통찰력을 얻으세요.

데이터베이스를 지정하세요.

기본적으로 읽기 전용입니다. 사용자가 명시하지 않는 한 아무것도 인프라 외부로 나가지 않습니다.