Claude Code MCP 서버 연동과 Hooks로 PostgreSQL·REST API 호출까지 자동화하기

// .claude/settings.json — MCP 서버 등록 예시
{
  "mcpServers": {
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@crystaldba/postgres-mcp", "--db-url", "postgresql://user:pass@localhost:5432/mydb"]
    },
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "slack": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"]
    }
  }
}

[Claude Code 에이전트]
    ↕ (MCP Transport: stdio / HTTP SSE)
[MCP 서버] ← PostgreSQL, REST API, GitHub, Slack 등
    ↕ (Hooks: PreToolUse / PostToolUse / Stop)
[자동화 스크립트 / 외부 웹훅]

// .claude/settings.json
{
  "mcpServers": {
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@crystaldba/postgres-mcp", "--db-url", "postgresql://readonly_user:pass@localhost/mydb", "--mode", "restricted"]
    }
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "mcp__postgres__query",
        "hooks": [
          {
            "type": "command",
            "command": "python3 scripts/log_query.py '$CLAUDE_TOOL_RESPONSE'"
          }
        ]
      }
    ]
  }
}

# scripts/log_query.py
import sys
import json
import os
import urllib.request
from datetime import datetime, timezone
 
def main():
    raw = sys.argv[1] if len(sys.argv) > 1 else ""
    try:
        response_data = json.loads(raw)
    except json.JSONDecodeError:
        response_data = {"raw": raw}
 
    payload = json.dumps({
        "tool": "postgres_query",
        "result": response_data,
        "timestamp": datetime.now(timezone.utc).isoformat()
    }).encode("utf-8")
 
    req = urllib.request.Request(
        os.environ.get("AUDIT_LOG_URL", "https://audit.example.com/log"),
        data=payload,
        headers={
            "Content-Type": "application/json",
            "Authorization": f"Bearer {os.environ['AUDIT_API_TOKEN']}"
        },
        method="POST"
    )
    try:
        urllib.request.urlopen(req)
    except Exception as e:
        # 감사 로그 실패가 조용히 묻히면 보안 목적이 훼손됨
        print(f"[AUDIT ERROR] 감사 로그 전송 실패: {e}", file=sys.stderr)
        sys.exit(1)
 
if __name__ == "__main__":
    main()

#!/bin/bash
# scripts/trigger_deploy.sh — PostToolUse 훅에 등록
 
# $CLAUDE_TOOL_INPUT을 jq로 파싱해서 변경 파일 경로를 추출
CHANGED_PATH=$(echo "$CLAUDE_TOOL_INPUT" | jq -r '.path // empty')
 
if [ -z "$CHANGED_PATH" ]; then
  exit 0
fi
 
if echo "$CHANGED_PATH" | grep -q "^src/"; then
  curl -s -X POST "https://ci.example.com/webhooks/deploy" \
    -H "Authorization: Bearer ${CI_TOKEN}" \
    -H "Content-Type: application/json" \
    -d "{\"file\": $(echo "$CHANGED_PATH" | jq -R .), \"triggered_by\": \"claude-code\"}"
  echo "CI triggered for: $CHANGED_PATH"
fi

// settings.json — 파일 쓰기 도구에 훅 연결
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "bash scripts/trigger_deploy.sh"
          }
        ]
      }
    ]
  }
}

# scripts/security_check.py
import sys
import json
import re
import os
 
DANGEROUS_PATTERNS = [
    r"\bDROP\s+TABLE\b",
    r"\bDROP\s+DATABASE\b",
    r"\bTRUNCATE\b",
    r"\bDELETE\s+FROM\b(?!.*WHERE)",  # WHERE 없는 DELETE — 단순화된 예시
    r"rm\s+-rf\s+/",
]
# 주의: 위 DELETE 패턴은 단순화된 예시입니다.
# 멀티라인 쿼리나 서브쿼리가 포함된 경우 오탐 가능성이 있습니다.
# 프로덕션에서는 AST 기반 SQL 파서 사용을 권장합니다.
 
def main():
    tool_input_raw = os.environ.get("CLAUDE_TOOL_INPUT", "")
    try:
        tool_input = json.loads(tool_input_raw)
    except json.JSONDecodeError:
        tool_input = {}
 
    command = tool_input.get("command", "") or tool_input.get("query", "")
 
    for pattern in DANGEROUS_PATTERNS:
        if re.search(pattern, command, re.IGNORECASE):
            print(f"[BLOCKED] 위험 패턴 감지: {pattern}", file=sys.stderr)
            sys.exit(2)  # exit 2 = 도구 실행 차단
 
    sys.exit(0)
 
if __name__ == "__main__":
    main()

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 scripts/security_check.py",
            "exitCodeControl": true
          }
        ]
      },
      {
        "matcher": "mcp__postgres__query",
        "hooks": [
          {
            "type": "command",
            "command": "python3 scripts/security_check.py",
            "exitCodeControl": true
          }
        ]
      }
    ]
  }
}

[pm-spec 에이전트]
  → 요구사항 파싱, 인수 조건 작성
  → 결과물: spec.md 저장
    ↓
  PostToolUse 훅 (Write 도구 감지 → spec.md 생성 확인)
    ↓
[architect-review 에이전트]
  → 아키텍처 검증, 플랫폼 제약 확인
  → 결과물: architecture.md 저장
    ↓
  Stop 훅 → Slack MCP로 팀 채널에 리뷰 완료 알림
    ↓
[implementer-tester 에이전트]
  → 코드 작성 + 테스트 실행
  → StopFailure 훅 → 실패 시 GitHub Issue 자동 생성

// settings.json — spec.md 생성 시 다음 에이전트 트리거
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "bash scripts/check_and_trigger_architect.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# scripts/check_and_trigger_architect.sh
WRITTEN_PATH=$(echo "$CLAUDE_TOOL_INPUT" | jq -r '.path // empty')
 
# spec.md가 생성된 경우에만 다음 단계 트리거
if [ "$WRITTEN_PATH" = "spec.md" ]; then
  echo "[PIPELINE] spec.md 생성 감지 → architect-review 에이전트 시작"
  # 실제 에이전트 트리거 방식은 팀 CI/CD 환경에 따라 다릅니다
  curl -s -X POST "https://ci.example.com/trigger/architect-review" \
    -H "Authorization: Bearer ${CI_TOKEN}"
fi