{
  "connections": {
    "user-service": {
      "name": "user-service",
      "type": "mysql",
      "host": "user-db.cluster-xxx.rds.amazonaws.com",
      "port": 3306,
      "user": "readonly_user",
      "password": "secure_password",
      "database": "user_service",
      "description": "사용자 서비스 DB",
      "tags": ["microservice", "user", "mysql"]
    },
    "order-service": {
      "name": "order-service",
      "type": "postgresql",
      "host": "order-db.cluster-yyy.rds.amazonaws.com",
      "port": 5432,
      "user": "readonly_user",
      "password": "secure_password",
      "database": "order_service",
      "description": "주문 서비스 DB",
      "tags": ["microservice", "order", "postgresql"]
    }
  },
  "defaultConnection": "user-service"
}

# 사용자 서비스 DB
DB_USER_HOST=user-db.cluster-xxx.rds.amazonaws.com
DB_USER_PORT=3306
DB_USER_TYPE=mysql
DB_USER_USER=readonly_user
DB_USER_PASSWORD=secure_password
DB_USER_DATABASE=user_service
DB_USER_DESCRIPTION=사용자 서비스 DB
DB_USER_TAGS=microservice,user,mysql
DB_USER_WRITE_ENABLED=false

# 주문 서비스 DB
DB_ORDER_HOST=order-db.cluster-yyy.rds.amazonaws.com
DB_ORDER_PORT=5432
DB_ORDER_TYPE=postgresql
DB_ORDER_USER=readonly_user
DB_ORDER_PASSWORD=secure_password
DB_ORDER_DATABASE=order_service
DB_ORDER_DESCRIPTION=주문 서비스 DB
DB_ORDER_TAGS=microservice,order,postgresql
DB_ORDER_WRITE_ENABLED=false

# 기본 연결
DB_DEFAULT_CONNECTION=user

{
  "mcpServers": {
    "multi-database": {
      "command": "node",
      "args": ["path/to/db-mcp/dist/multi-database-server.js"],
      "env": {
        "DB_CONFIG_FILE": "./db-config.json"
      }
    }
  }
}

{
  "mcpServers": {
    "db-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/db-mcp/dist/multi-index.js"],
      "env": {
        "DB_CONFIG_FILE": "/absolute/path/to/db-mcp/db-config.json",
        "LOG_LEVEL": "info",
        "MCP_SERVER_NAME": "db-mcp"
      }
    }
  }
}

# MCP 서버 연결 확인
claude mcp list

# 헬스체크 실행
# Claude Code에서: "db-mcp 서버 헬스체크 실행해줘"

{
  "mcpServers": {
    "user-db": {
      "command": "node",
      "args": ["path/to/db-mcp/dist/index.js"],
      "env": {
        "DB_TYPE": "mysql",
        "MYSQL_HOST": "user-db.cluster-xxx.rds.amazonaws.com",
        "MYSQL_DB": "user_service"
      }
    },
    "order-db": {
      "command": "node",
      "args": ["path/to/db-mcp/dist/index.js"],
      "env": {
        "DB_TYPE": "postgresql",
        "POSTGRES_HOST": "order-db.cluster-yyy.rds.amazonaws.com",
        "POSTGRES_DB": "order_service"
      }
    }
  }
}

"사용자 서비스와 주문 서비스 데이터를 비교해서 보여줘"
→ 여러 DB에서 데이터를 조회하여 통합 분석

"microservice 태그가 붙은 모든 DB 상태를 확인해줘"
→ 태그 기반으로 DB 그룹 관리

"모든 데이터베이스 연결 상태를 한번에 확인해줘"
→ 전체 인프라 상태 모니터링

"사용자 ID로 모든 서비스의 관련 데이터를 찾아줘"
→ 마이크로서비스 간 데이터 추적

const SECURITY_LIMITS = {
  MAX_EXECUTION_TIME: 30000,    // 30초
  MAX_RESULT_ROWS: 10000,       // 최대 10,000행
  MAX_RESULT_SIZE: '50MB',      // 최대 50MB
  MAX_QUERY_LENGTH: 10000,      // 최대 10,000자
  ALLOWED_KEYWORDS: [
    'SELECT', 'FROM', 'WHERE', 'JOIN', 'ORDER BY',
    'GROUP BY', 'HAVING', 'LIMIT', 'OFFSET',
    'SHOW', 'DESCRIBE', 'EXPLAIN'
  ]
};

npm install

# MySQL 연결 정보 (로컬 또는 원격)
DB_TYPE=mysql                           # 명시적 타입 지정 (선택사항)
MYSQL_HOST=localhost                    # 또는 AWS RDS 엔드포인트
MYSQL_PORT=3306
MYSQL_DB=mydb
MYSQL_USER=readonly_user
MYSQL_PASSWORD=secure_password

# 원격 DB 설정 (AWS RDS 예시)
# MYSQL_HOST=mydb.cluster-xxx.us-east-1.rds.amazonaws.com
# MYSQL_SSL_MODE=REQUIRED
# MYSQL_SSL_CA=/path/to/rds-ca-2019-root.pem
# MYSQL_CONNECTION_TIMEOUT=60000
# MYSQL_ACQUIRECONNECTION_TIMEOUT=60000

# PostgreSQL 연결 정보 (로컬 또는 원격)
DB_TYPE=postgresql                      # 명시적 타입 지정 (선택사항)
POSTGRES_HOST=localhost                 # 또는 AWS RDS 엔드포인트
POSTGRES_PORT=5432
POSTGRES_DB=mydb
POSTGRES_USER=readonly_user
POSTGRES_PASSWORD=secure_password

# 원격 DB 설정 (AWS RDS PostgreSQL 예시)
# POSTGRES_HOST=mydb.cluster-xxx.us-east-1.rds.amazonaws.com
# POSTGRES_SSL_MODE=REQUIRED
# POSTGRES_SSL_CA=/path/to/rds-ca-2019-root.pem
# POSTGRES_CONNECTION_TIMEOUT=60000

MAX_QUERY_EXECUTION_TIME=30000
MAX_RESULT_ROWS=10000
ENABLE_QUERY_LOGGING=true

{
  "mcpServers": {
    "database": {
      "command": "node",
      "args": ["path/to/db-mcp/dist/index.js"],
      "env": {
        "DB_TYPE": "mysql",
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_DB": "mydb",
        "MYSQL_USER": "readonly_user",
        "MYSQL_PASSWORD": "secure_password"
      }
    }
  }
}

{
  "mcpServers": {
    "database": {
      "command": "node",
      "args": ["path/to/db-mcp/dist/index.js"],
      "env": {
        "DB_TYPE": "postgresql",
        "POSTGRES_HOST": "localhost",
        "POSTGRES_PORT": "5432",
        "POSTGRES_DB": "mydb",
        "POSTGRES_USER": "readonly_user",
        "POSTGRES_PASSWORD": "secure_password"
      }
    }
  }
}

💬 "user-service와 order-service에서 최근 1주일 동안 신규 가입한 사용자들의 주문 패턴을 비교 분석해줘"

🤖 Claude가 자동으로:
1. user-service DB에서 최근 가입자 조회
2. order-service DB에서 해당 사용자들의 주문 데이터 조회
3. 크로스 데이터베이스 분석으로 패턴 식별
4. 통합 리포트 생성

💬 "production 태그가 붙은 모든 데이터베이스의 상태를 확인하고 성능 문제가 있는 곳을 찾아줘"

🤖 결과:
- 5개 프로덕션 DB 중 4개 정상, 1개 경고
- analytics-db: 응답시간 3.2초 (평균의 2배)
- 연결 풀 사용률: order-service 90% (주의 필요)

💬 "모든 서비스의 사용자 테이블에서 이메일 형식이 잘못된 데이터를 찾아줘"

🤖 자동 실행:
- user-service.users 테이블: 이메일 패턴 검증
- auth-service.profiles 테이블: 이메일 중복 검사
- notification-service.recipients 테이블: 유효하지 않은 도메인 탐지

💬 "user_id 컬럼을 사용하는 모든 테이블과 관계를 찾아서 스키마 변경 시 영향도를 분석해줘"

🤖 결과:
- 직접 참조: 15개 테이블
- 간접 참조: 8개 테이블
- 영향 받는 서비스: user, order, payment, notification, analytics
- 권장사항: 단계적 마이그레이션 계획 필요

💬 "지난 달 가장 많이 팔린 상품 카테고리는 뭐야?"

🤖 생성된 SQL:
SELECT c.name, COUNT(oi.product_id) as sales_count
FROM order_items oi
JOIN products p ON oi.product_id = p.id
JOIN categories c ON p.category_id = c.id
WHERE oi.created_at >= DATE_SUB(NOW(), INTERVAL 1 MONTH)
GROUP BY c.id
ORDER BY sales_count DESC
LIMIT 1

💬 "각 지역별로 월별 매출 추이를 보여주고, 전년 동기 대비 성장률도 계산해줘"

🤖 자동으로:
1. 지역, 날짜별 매출 집계
2. 전년 동기 데이터 조회
3. 성장률 계산
4. 시각화 가능한 형태로 결과 정리

💬 "현재 느리게 실행되고 있는 쿼리가 있는 데이터베이스를 찾아줘"

🤖 실시간 분석:
- order-service: 3개 쿼리가 10초 이상 실행 중
- analytics-db: 대용량 집계 쿼리 진행 중 (정상)
- user-service: 모든 쿼리 1초 이내 (양호)

💬 "각 데이터베이스의 테이블별 크기를 조회하고 정리가 필요한 테이블을 추천해줘"

🤖 분석 결과:
- log_events 테이블: 15GB (파티셔닝 권장)
- user_sessions 테이블: 8GB (TTL 설정 권장)
- temp_data 테이블: 3GB (정리 스케줄 필요)

┌─────────────────────────────────────────────────────────────┐
│                    Claude AI Client                         │
├─────────────────────────────────────────────────────────────┤
│                Model Context Protocol                       │
├─────────────────────────────────────────────────────────────┤
│              Multi-Database MCP Server                      │
│  ┌─────────────────┐  ┌──────────────────┐  ┌─────────────┐ │
│  │ Connection Mgr  │  │  Query Executor  │  │ Schema Mgr  │ │
│  └─────────────────┘  └──────────────────┘  └─────────────┘ │
├─────────────────────────────────────────────────────────────┤
│              Database Adapter Layer                         │
│  ┌─────────────────┐  ┌──────────────────┐  ┌─────────────┐ │
│  │  MySQL Adapter  │  │PostgreSQL Adapter│  │ Future DBs  │ │
│  └─────────────────┘  └──────────────────┘  └─────────────┘ │
├─────────────────────────────────────────────────────────────┤
│                    Database Layer                           │
│  ┌─────────────────┐  ┌──────────────────┐  ┌─────────────┐ │
│  │ User Service DB │  │ Order Service DB │  │Analytics DB │ │
│  │     (MySQL)     │  │   (PostgreSQL)   │  │(PostgreSQL) │ │
│  └─────────────────┘  └──────────────────┘  └─────────────┘ │
└─────────────────────────────────────────────────────────────┘