Последняя активность 1744017009

Версия 3ba3481649fb09ba123a46da79125cd16bd70377

Claude(AI) + postgres(MCP) 활용법.md Исходник

MCP란?

배경지식

  • AI가 우리가 사용 중인 도구나 인프라에 접근해 데이터를 처리하는 프로토콜
  • 단, AI가 직접 우리의 서버나 도구에 접근할 수 없기 때문에 로컬 환경에서 접속을 돕는 클라이언트 서버 필요

0. 기본사항

  • MCP를 통해 AI에 대한 질의를 통해 데이터베이스를 조회하는 예시입니다.
  • 예제에서 사용하는 MCP는 Claude팀 공식 배포판입니다.
  • AI가 사내 DB 조회 권한을 부여 받습니다.
  • MCP가 사내 DB 데이터를 조회하는 경우 반드시 사용자가 허용해야만 기능이 활성화 됩니다. (채팅 단위)

1. Docker Desktop 설치

  • 클라이언트 서버는 Docker를 통해 쉽게 구동 가능
  • Download Docker Desktop > Download For Windows = AMD64 다운로드
  • 패키지 실행 > 기본 옵션으로 설치 > Close and reboot 선택
  • WSL 하위 패키지 설치 진행 (명령프롬프트를 읽고 지시대로 이행)
    • Docker의 엔진으로 작동되기 때문에 WSL이 미설치된 경우 사용할 수 없음.
  • WSL 설치 이후 도커 기본 설정 진행 (로그인을 요구하는 경우 Skip 가능)

2. Claude Desktop 설치

  • Claude 서비스는 웹으로 사용 가능한 서비스이지만 MCP와 함께 사용하려면 데스크톱 설치 필요
  • 데스크톱 설치 이후 구동
  • config 수정 필요 (vscode가 설치되어 있지 않다면 직접 파일탐색기 접근필요)
# 명령어
notepad %APPDATA%\Claude\claude_desktop_config.json
# 아래 내용 붙여넣기 후 저장
{
  "mcpServers": {
    "postgres": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/postgres", 
        "postgresql://<username>:<password>@<host>:<port>/<dbname>"] # 이 부분은 직접 수정
    }
  }
}

3. Claude Desktop 실행 후 테이블 명령 조회 명령어 실행해 테스트