pg-aiguide

pg-aiguide

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

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

• 공식 PostgreSQL 매뉴얼에 대한 의미론적 검색 (버전 인식)
• AI 최적화 "스킬" — AI 에이전트가 자동으로 사용하는 선별되고 검증된 Postgres 모범 사례
• 확장 생태계 문서, TimescaleDB부터 시작하며 더 많은 확장이 곧 제공될 예정입니다

다음과 같이 사용할 수 있습니다:

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

⭐ 왜 pg-aiguide인가?

AI 코딩 도구는 종종 다음과 같은 Postgres 코드를 생성합니다:

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

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

차이점 확인

https://github.com/user-attachments/assets/5a426381-09b5-4635-9050-f55422253a3d

🚀 빠른 시작

에이전트 스킬

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

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

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

claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide

환경별 설치

claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide

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

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

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pg-aiguide": {
      "type": "remote",
      "url": "https://mcp.tigerdata.com/docs"
    }
  }
}

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

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

{
  "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