pg-aiguide MCP Server

pg-aiguide

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

pg-aiguide는 AI 코딩 도구가 훨씬 더 나은 PostgreSQL 코드를 작성하도록 도와줍니다. 다음을 제공합니다:

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

다음과 같이 사용하세요:

• 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

또는 대화형으로 개별 스킬을 선택하세요:

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

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 기능

🔌 생태계 문서

현재 지원:

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

곧 지원 예정:

• pgvector

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

🛠 개발

다음에 대한 내용은 DEVELOPMENT.md를 참조하세요:

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

🤝 기여

다음을 환영합니다:

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

📄 라이선스

Apache 2.0