AI 최적화된 PostgreSQL 전문성: pg-aiguide

AI 최적화된 PostgreSQL 전문성을 위한 코드 작성 도구

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

공식 PostgreSQL 매뉴얼에 대한 의미론적 검색 (Semantic search) (버전 인식)
AI 최적화된 "기술" (Skills) — AI 에이전트가 자동으로 사용하는 정제된, 의견 기반 Postgres 모범 사례
확장 생태계 문서, TimescaleDB 를 시작으로 곧 추가 예정

사용 방법:

**에이전트 기술 (Agent Skills)**을 통해 npx skills 사용
— Claude Code, Cursor, Codex, Gemini CLI 및 40 개 이상의 다른 에이전트와 호환됨

• 공개 MCP 서버 — 어떤 AI 코딩 에이전트든 사용할 수 있음
• Claude Code 플러그인 — Claude 의 네이티브 기술 지원과 함께 최적화됨

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

• 구식 (outdated)
• 제약 조건 및 인덱스 누락
• 현대 PG 기능에 무관심
• 실제 세계 모범 사례와 불일치

pg-aiguide 는 AI 에이전트에 깊은 버전화된 PostgreSQL 지식과 검증된 패턴을 제공함으로써 이를 수정합니다.

how-to-train-your-agent.mp4

영상 자막

Claude Code 에 주어진 프롬프트:

"e-commerce 웹사이트에 대한 스키마를 tiger mcp 서버가 비활성화되어 있을 때와 활성화되어 있을 때 각각 두 번 설명해 주세요. 각 경우에 대해 현재 작업 디렉토리에 해당 스키마를 별도의 파일로 작성하세요. 그런 다음 두 파일을 비교하여 더 나은 스키마를 생성한 접근 방식을 양적 및 질적 이유 모두를 사용하여 알려주세요. 이 예제에서는 표준 Postgres 만 사용하세요."

결과 (요약):

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

결론: pg-aiguide 는 더 견고하고 성능이 좋으며 유지보수가 쉬운 스키마를 생성합니다.

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 지식을 원하시면 TigerData 가 호스팅하는 공개 MCP 서버 엔드포인트를 추가하여 공식 PostgreSQL, TimescaleDB, PostGIS 매뉴얼에 대한 의미론적 검색을 제공하세요.

PostgreSQL, TimescaleDB 및 PostGIS 문서에 대한 의미론적 검색을 위해 공개 MCP 서버를 추가하세요:

JSON 을 사용한 수동 MCP 설정

{
"mcpServers": {
"pg-aiguide": {
...

또는 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 디렉토리에 있는 기술과 TigerData 가 호스팅하는 PostgreSQL 문서 검색을 위한 공개 MCP 서버 엔드포인트를 사용합니다.

Codex

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

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

Cursor

원클릭 설치 또는 다음을 .cursor/mcp.json 에 추가하세요:

{
"mcpServers": {
"pg-aiguide": {
...

Gemini CLI

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

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

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

설치가 완료되면 pg-aiguide 는 Postgres 관련 질문이나 스키마 설계에 답변할 수 있습니다.

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

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

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

당신은 숙련된 소프트웨어 엔지니어입니다. IoT 기기 회사용 Postgres 스키마 생성 작업을 수행하는 데 도움이 필요합니다. 기기는 공장 바닥의 환경 데이터를 수집합니다. 데이터에는 온도, 습도, 압력을 주요 데이터 포인트로 포함하며, 기기마다 다른 측정값도 포함됩니다. 각 기기는 고유한 ID 와 가독성 있는 이름을 가지고 있습니다. 우리는 데이터 수집 시간을 기록하고 싶습니다. 최근 데이터 분석은 측정값을 기반으로 이상치와 비정상치를 찾는 것뿐만 아니라 특정 기기의 데이터를 임의 분석에도 분석하는 것을 포함합니다. 역사적 데이터 분석은 단일 기기의 데이터 역사를 분석하거나 장기적인 기간 동안 모든 기기에 대한 통계를 얻는 것을 포함합니다.

다중 문서 소스 간의 의미론적 (벡터 유사성) 및 키워드 (BM25) 검색을 지원하는 통합 검색 도구:search_docs

postgres

• 버전별로 제한된 공식 PostgreSQL 매뉴얼tiger

• Tiger Data 의 문서 (TimescaleDB 와 생태계)postgis

• PostGIS 공간 확장자 문서

view_skill

AI 코딩 어시스턴트에서 자동으로 사용되며 정제된, 관점 있는 PostgreSQL 모범 사례 기술을 노출합니다. 이 기술들은 다음에 대한 지침을 제공합니다:

• 스키마 설계
• 인덱싱 전략
• 데이터 타입
• 데이터 무결성과 제약 조건
• 네이밍 규칙
• 성능 튜닝
• 현대 PostgreSQL 기능

현재 지원되는 내용:

TimescaleDB(문서 + 기술)PostGIS(문서)

곧 출시 예정:

pgvector

추가 확장자와 도구를 위한 기여를 환영합니다.

DEVELOPMENT.md 를 확인하세요:

• 로컬에서 MCP 서버 실행
• 새로운 기술 추가
• 새로운 문서 추가

우리는 다음을 환영합니다:

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

Apache 2.0