pg-aiguide

pg-aiguide
코딩 어시스턴트를 위한 AI 최적화 PostgreSQL 전문 지식

pg-aiguide는 AI 코딩 도구가 훨씬 더 나은 PostgreSQL 코드를 작성하도록 돕습니다. 제공하는 기능:

공식 PostgreSQL 매뉴얼에 대한 시맨틱 검색 (버전 인식)
AI 최적화 "스킬" — AI 에이전트가 자동으로 사용하는, 선별되고 의견이 반영된 Postgres 모범 사례
확장 생태계 문서 — TimescaleDB를 시작으로, 더 많은 확장이 곧 추가될 예정

사용 방법:

npx skills를 통한 Agent Skills — Claude Code, Cursor, Codex, Gemini CLI 및 40개 이상의 다른 에이전트와 호환
모든 AI 코딩 에이전트와 함께 사용할 수 있는 공개 MCP 서버, 또는
Claude의 네이티브 스킬 지원에 최적화된 Claude Code 플러그인

⭐ pg-aiguide를 사용하는 이유
AI 코딩 도구는 종종 다음과 같은 Postgres 코드를 생성합니다:

구식
제약 조건과 인덱스 누락
최신 PG 기능을 인지하지 못함
실제 모범 사례와 일치하지 않음

pg-aiguide는 AI 에이전트에 깊이 있고 버전이 지정된 PostgreSQL 지식과 검증된 패턴을 제공하여 이를 해결합니다.

차이점 보기

how-to-train-your-agent.mp4

비디오 스크립트
Claude Code에 주어진 프롬프트:

전자상거래 웹사이트용으로 생성할 스키마를 두 번 설명해 주세요. 먼저 tiger mcp 서버를 비활성화한 상태로, 그다음 tiger mcp 서버를 활성화한 상태로요. 각각의 경우 스키마를 현재 작업 디렉터리의 별도 파일에 작성하세요. 그런 다음 두 파일을 비교하고, 정성적 및 정량적 근거를 모두 사용하여 어떤 접근 방식이 더 나은 스키마를 생성했는지 알려주세요. 이 예제에서는 표준 Postgres만 사용하세요.

결과 (요약):

4배 더 많은 제약 조건
55% 더 많은 인덱스 (부분/표현식 인덱스 포함)
PG17 권장 패턴
최신 기능 ( GENERATED ALWAYS AS IDENTITY , NULLS NOT DISTINCT )
더 깔끔한 명명 및 문서화

결론: pg-aiguide는 더 견고하고 성능이 뛰어나며 유지 관리가 쉬운 스키마를 생성합니다.

🚀 빠른 시작
Agent Skills
AI 코딩 에이전트를 위한 선별된 PostgreSQL 모범 사례 스킬을 설치하세요:

npx skills add timescale/pg-aiguide --skill postgres
또는 기존 PostgreSQL 데이터베이스를 조사하기 위한 스키마 탐색 스킬을 설치하세요:

npx skills add timescale/pg-aiguide --skill schema-exploration
또는 개별 스킬을 대화형으로 선택하세요:

npx skills add timescale/pg-aiguide
Claude Code, Cursor, Codex, Gemini CLI, VS Code 및 40개 이상의 다른 에이전트와 호환됩니다 .

더 깊은 PostgreSQL 지식을 위해 MCP 서버도 추가하여 에이전트에 공식 PostgreSQL, TimescaleDB, PostGIS 매뉴얼에 대한 시맨틱 검색 기능을 제공하세요.

MCP 서버
PostgreSQL, TimescaleDB, PostGIS 문서에 대한 시맨틱 검색을 위해 공개 MCP 서버를 추가하세요 :

https://mcp.tigerdata.com/docs

JSON을 사용한 수동 MCP 구성
{
"mcpServers" : {
"pg-aiguide" : {
"url" : " https://mcp.tigerdata.com/docs "
}
}
}

또는 Claude Code 플러그인으로 사용할 수 있습니다 :

claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide
환경별 설치

Claude Code
이 저장소는 claude code 마켓플레이스 플러그인으로 사용됩니다. 설치하려면 다음을 실행하세요:

claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide
이 플러그인은 skills 디렉터리에서 사용 가능한 스킬과 PostgreSQL 문서 검색을 위해 TigerData가 호스팅하는
공개 MCP 서버 엔드포인트를 사용합니다.

Codex
다음을 실행하여 codex에 MCP 서버를 추가하세요:

codex mcp add --url " https://mcp.tigerdata.com/docs " pg-aiguide

Cursor
원클릭 설치:

또는 다음을 .cursor/mcp.json에 추가하세요

{
"mcpServers" : {
"pg-aiguide" : {
"url" : " https://mcp.tigerdata.com/docs "
}
}
}

Gemini CLI
다음을 실행하여 Gemini CLI에 MCP 서버를 추가하세요:

gemini mcp add -s user pg-aiguide " https://mcp.tigerdata.com/docs " -t http

OpenCode
전역 OpenCode 구성 파일( ~/.config/opencode/opencode.json ) 또는
프로젝트 수준 opencode.json에 다음을 추가하세요. 파일 위치에 대한 자세한 내용은 OpenCode 구성 문서를,
mcp 옵션에 대한 자세한 내용은 MCP 서버 문서를 참조하세요.

{
"$schema" : " https://opencode.ai/config.json " ,
"mcp" : {
"pg-aiguide" : {
"type" : " remote " ,
"url" : " https://mcp.tigerdata.com/docs "
}
}
}
프롬프트에 use pg-aiguide를 추가하여 pg-aiguide 도구를 사용하세요.

Visual Studio
버튼을 클릭하여 설치하세요:

VS Code
버튼을 클릭하여 설치하세요:

또는 다음을 실행하여 VS Code에 MCP 서버를 추가하세요:

code --add-mcp ' {"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"} '

VS Code Insiders
버튼을 클릭하여 설치하세요:

또는 다음을 실행하여 VS Code Insiders에 MCP 서버를 추가하세요:

code-insiders --add-mcp ' {"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"} '

Windsurf
다음을 ~/.codeium/windsurf/mcp_config.json에 추가하세요

{
"mcpServers" : {
"pg-aiguide" : {
"serverUrl" : " https://mcp.tigerdata.com/docs "
}
}
}

💡 첫 번째 프롬프트
설치가 완료되면 pg-aiguide는 Postgres 질문에 답하거나 스키마를 설계할 수 있습니다.

간단한 스키마 예제 프롬프트

사용자 이름과 고유 이메일 주소를 저장하기 위한 Postgres 테이블 스키마를 생성하세요.

복잡한 스키마 예제 프롬프트

당신은 시니어 소프트웨어 엔지니어입니다. IoT 기기 회사를 위한 Postgres 스키마를 생성하는 작업이 주어졌습니다.
기기는 공장 바닥에서 환경 데이터를 수집합니다. 데이터에는 온도, 습도, 압력이 주요 데이터 포인트로 포함되며,
기기마다 다른 기타 측정값도 포함됩니다. 각 기기에는 고유 ID와 사람이 읽을 수 있는 이름이 있습니다.
데이터가 수집된 시간도 기록하려고 합니다. 최근 데이터 분석에는 측정값을 기반으로 이상치와 이상 현상을 찾는 것과
특정 기기의 데이터를 분석하여 임시 분석을 수행하는 것이 포함됩니다. 과거 데이터 분석에는 한 기기의 데이터 이력을
분석하거나 장기간에 걸쳐 모든 기기의 통계를 얻는 것이 포함됩니다.

기능
문서 검색 (MCP 도구)

search_docs
여러 문서 소스에 걸쳐 시맨틱(벡터 유사도) 및 키워드(BM25) 검색을 지원하는 통합 검색 도구:

postgres - 공식 PostgreSQL 매뉴얼, 버전별 범위 지정
tiger - Tiger Data의 문서 (TimescaleDB 및 생태계)
postgis - PostGIS 공간 확장 문서

스킬 (AI 최적화 모범 사례)

view_skill

AI 코딩 어시스턴트가 자동으로 사용하는, 선별되고 의견이 반영된 PostgreSQL 모범 사례 스킬을 제공합니다.

이 스킬은 다음에 대한 지침을 제공합니다:

기존 PostgreSQL 스키마 및 객체 탐색
스키마 설계
인덱싱 전략
데이터 유형
데이터 무결성 및 제약 조건
명명 규칙
성능 튜닝
최신 PostgreSQL 기능

🔌 생태계 문서
현재 지원:

TimescaleDB (문서 + 스킬)
PostGIS (문서)

곧 추가 예정:

pgvector

추가 확장 및 도구에 대한 기여를 환영합니다.

🛠 개발
다음을 참조하세요: DEVELOPMENT.md

로컬에서 MCP 서버 실행
새 스킬 추가
새 문서 추가

🤝 기여
환영합니다:

새로운 Postgres 모범 사례 스킬
추가 문서 코퍼스
검색 품질 개선
버그 보고 및 기능 아이디어

📄 라이선스
Apache 2.0