@cano721/mysql-mcp-server

v0.10.0

Published

5 days ago

An MCP server that provides read-only access to MySQL databases.

Downloads

2,992

0High
0Medium
0Low

cano721

mcp mysql database model-context-protocol ai llm

MySQL 데이터베이스 접근 MCP 서버 (@cano721/mysql-mcp-server)

이 MCP 서버는 MySQL 데이터베이스에 읽기 전용 접근을 제공합니다. 다음과 같은 기능을 제공합니다:

사용 가능한 데이터베이스 목록 조회
데이터베이스의 테이블 목록 조회
테이블 스키마 설명
읽기 전용 SQL 쿼리 실행

📋 목차

보안 기능

읽기 전용 접근: SELECT, SHOW, DESCRIBE 문 항상 허용
분석 도구: EXPLAIN, EXPLAIN ANALYZE 기본 허용 (읽기 전용 분석)
쿼리 검증: SQL 인젝션 방지 및 데이터 수정 시도 차단
쿼리 타임아웃: 장시간 실행되는 쿼리로부터 리소스 보호
행 제한: 과도한 데이터 반환 방지 (최대 1000행)
세밀한 권한 제어: 각 분석 도구별 개별 활성화/비활성화

지원되는 SQL 명령어:

SELECT - 데이터 조회 및 분석 (항상 허용)
SHOW - 데이터베이스/테이블/인덱스 정보 조회 (항상 허용)
DESCRIBE / DESC - 테이블 구조 및 컬럼 정보 (항상 허용)
EXPLAIN - 쿼리 실행 계획 분석 (기본 허용, 읽기 전용)
EXPLAIN ANALYZE - 쿼리 실제 실행 및 성능 분석 (기본 허용, 읽기 전용)

요구사항

Node.js: 18.0.0 이상 → Node.js 업데이트 방법
npm: 8.0.0 이상 (Node.js와 함께 설치됨)

💡 Node.js 버전이 낮다면? 여기를 클릭해서 업데이트 방법을 확인하세요

설치

방법 1: npx 사용 (대부분의 MCP 클라이언트에서 권장)

npx를 사용하면 별도 설치 없이 바로 사용할 수 있습니다:

# 설치 없이 바로 사용 가능
npx @cano721/mysql-mcp-server

💡 항상 최신 버전 사용하기:

# @latest 태그를 붙이면 캐시를 무시하고 항상 최신 버전을 가져옵니다
npx @cano721/mysql-mcp-server@latest

MCP 설정에서도 @latest를 사용하면 항상 최신 버전을 사용할 수 있습니다:

{
  "args": ["@cano721/mysql-mcp-server@latest"]
}

주의: 일부 MCP 클라이언트에서 npx가 제대로 작동하지 않을 수 있습니다. 그런 경우 방법 2를 사용하세요.

방법 2: 전역 설치 (npx가 안 될 때 권장)

npx에 문제가 있거나 더 안정적인 연결을 원한다면:

# 전역 설치
npm install -g @cano721/mysql-mcp-server

# 설치 확인
mysql-mcp-server --version

방법 3: 소스에서 빌드

개발이나 커스터마이징이 필요한 경우:

# 저장소 복제
git clone https://github.com/cano721/mysql-mcp-server.git
cd mysql-mcp-server

# 의존성 설치 및 빌드
npm install
npm run build

방법 4: Smithery를 통한 설치

Claude AI용 MySQL 데이터베이스 접근 MCP 서버를 Smithery를 통해 자동으로 설치:

npx -y @smithery/cli install @cano721/mysql-mcp-server --client claude

2. 환경 변수 설정

서버는 다음 환경 변수가 필요합니다:

필수 환경 변수:

MYSQL_HOST: 데이터베이스 서버 호스트명
MYSQL_USER: 데이터베이스 사용자명

선택적 환경 변수:

MYSQL_PORT: 데이터베이스 서버 포트 (기본값: 3306)
MYSQL_PASSWORD: 데이터베이스 비밀번호 (보안 연결에 권장)
MYSQL_DATABASE: 기본 데이터베이스명
MYSQL_QUERY_TIMEOUT: 쿼리 타임아웃 (밀리초, 기본값: 60000 = 60초)

보안 설정:

MYSQL_ALLOW_EXPLAIN: EXPLAIN 쿼리 허용 여부 (기본값: true, 비활성화: false)
MYSQL_ALLOW_ANALYZE: ANALYZE 쿼리 허용 여부 (기본값: true, 비활성화: false)

3. MCP 설정에 추가

MCP 설정 파일에 다음 구성을 추가하세요:

npx 사용 시:

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["@cano721/mysql-mcp-server@latest"],
      "env": {
        "MYSQL_HOST": "your-mysql-host",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your-mysql-user",
        "MYSQL_PASSWORD": "your-mysql-password",
        "MYSQL_DATABASE": "your-default-database"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

전역 설치 후 사용 시:

{
  "mcpServers": {
    "mysql": {
      "command": "mysql-mcp-server",
      "args": [],
      "env": {
        "MYSQL_HOST": "your-mysql-host",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your-mysql-user",
        "MYSQL_PASSWORD": "your-mysql-password",
        "MYSQL_DATABASE": "your-default-database"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

소스에서 빌드한 경우:

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["/path/to/mysql-mcp-server/build/index.js"],
      "env": {
        "MYSQL_HOST": "your-mysql-host",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your-mysql-user",
        "MYSQL_PASSWORD": "your-mysql-password",
        "MYSQL_DATABASE": "your-default-database"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

사용 가능한 도구

list_databases

MySQL 서버에서 접근 가능한 모든 데이터베이스를 나열합니다.

매개변수: 없음

예제:

{
  "server_name": "mysql",
  "tool_name": "list_databases",
  "arguments": {}
}

list_tables

지정된 데이터베이스의 모든 테이블을 나열합니다.

매개변수:

database (선택사항): 데이터베이스명 (지정하지 않으면 기본값 사용)

예제:

{
  "server_name": "mysql",
  "tool_name": "list_tables",
  "arguments": {
    "database": "my_database"
  }
}

describe_table

특정 테이블의 스키마를 보여줍니다.

매개변수:

database (선택사항): 데이터베이스명 (지정하지 않으면 기본값 사용)
table (필수): 테이블명

예제:

{
  "server_name": "mysql",
  "tool_name": "describe_table",
  "arguments": {
    "database": "my_database",
    "table": "my_table"
  }
}

execute_query

읽기 전용 SQL 쿼리를 실행합니다.

매개변수:

query (필수): SQL 쿼리 (SELECT, SHOW, DESCRIBE, EXPLAIN 문만 허용)
database (선택사항): 데이터베이스명 (지정하지 않으면 기본값 사용)

지원되는 쿼리 유형:

SELECT - 데이터 조회
SHOW - 데이터베이스/테이블 정보 표시
DESCRIBE / DESC - 테이블 구조 설명
EXPLAIN - 쿼리 실행 계획 분석

예제:

{
  "server_name": "mysql",
  "tool_name": "execute_query",
  "arguments": {
    "database": "my_database",
    "query": "SELECT * FROM my_table LIMIT 10"
  }
}

EXPLAIN 사용 예제:

{
  "server_name": "mysql",
  "tool_name": "execute_query",
  "arguments": {
    "database": "my_database",
    "query": "EXPLAIN SELECT * FROM my_table WHERE id = 1"
  }
}

explain_query

쿼리 실행 계획을 분석합니다 (MYSQL_ALLOW_EXPLAIN=true 필요).

매개변수:

query (필수): 분석할 SQL 쿼리
database (선택사항): 데이터베이스명
format (선택사항): 출력 형식 (TRADITIONAL, JSON, TREE)

예제:

{
  "server_name": "mysql",
  "tool_name": "explain_query",
  "arguments": {
    "database": "my_database",
    "query": "SELECT * FROM users WHERE id = 1",
    "format": "JSON"
  }
}

analyze_query

쿼리를 실제로 실행하면서 성능 통계를 분석합니다 (MYSQL_ALLOW_ANALYZE=true 필요).

EXPLAIN ANALYZE 구문을 사용하여 쿼리를 실제로 실행하고, 각 단계별 실행 시간과 행 수 등의 상세한 성능 정보를 제공합니다.

매개변수:

query (필수): 분석할 SQL 쿼리 (SELECT 문)
database (선택사항): 데이터베이스명

주의: 이 도구는 쿼리를 실제로 실행하므로, 대용량 데이터 조회 시 시간이 오래 걸릴 수 있습니다.

예제:

{
  "server_name": "mysql",
  "tool_name": "analyze_query",
  "arguments": {
    "database": "my_database",
    "query": "SELECT * FROM users WHERE id = 1"
  }
}

get_related_tables

특정 테이블과 FK로 연결된 모든 연관 테이블을 depth별로 조회합니다.

매개변수:

table (필수): 연관 테이블을 찾을 기준 테이블명
database (선택사항): 데이터베이스명
depth (선택사항): 탐색할 최대 깊이 (기본값: 3, 10 초과 시 경고)

검색 방법:

FK 제약조건 기반: 실제 Foreign Key가 설정된 테이블만 조회

예제:

{
  "server_name": "mysql",
  "tool_name": "get_related_tables",
  "arguments": {
    "database": "my_database",
    "table": "user",
    "depth": 2
  }
}

응답 예시:

{
  "root_table": "user",
  "database": "my_database",
  "requested_depth": 2,
  "fk_relations_count": 55,
  "total_relations": 55,
  "circular_references_detected": false,
  "fk_relations": [
    {
      "depth": 1,
      "child_table": "user_matching_information",
      "fk_column": "user_sn",
      "parent_table": "user",
      "constraint_name": "FK_USER_MATCHING_INFORMATION_USER_SN"
    }
  ]
}

순환참조 감지 예시:

{
  "root_table": "user",
  "circular_references_detected": true,
  "circular_references": [
    {
      "path": ["user", "profile", "user"],
      "description": "user → profile → user"
    }
  ],
  "circular_reference_note": "⚠️ 순환참조가 감지되었습니다 (1개). 이미 방문한 테이블은 재탐색하지 않았습니다."
}

성능 최적화:

v0.9.4부터 전체 FK 관계를 한 번에 로드하여 메모리에서 BFS 수행
쿼리 횟수: O(n) → O(1) (n = 탐색할 테이블 수)
대규모 데이터베이스에서도 빠른 응답 보장

참고: 응답은 JSON 배열 형태로 제공됩니다. 테이블이나 CSV 형식이 필요한 경우 LLM에게 변환을 요청하세요.


**SHOW 명령어 예제**:
```json
{
  "server_name": "mysql",
  "tool_name": "execute_query",
  "arguments": {
    "database": "my_database",
    "query": "SHOW CREATE TABLE my_table"
  }
}

고급 연결 풀 설정

MySQL 연결 풀 동작을 더 세밀하게 제어하려면 추가 매개변수를 설정할 수 있습니다:

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["@cano721/mysql-mcp-server@latest"],
      "env": {
        "MYSQL_HOST": "your-mysql-host",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your-mysql-user",
        "MYSQL_PASSWORD": "your-mysql-password",
        "MYSQL_DATABASE": "your-default-database",
        
        "MYSQL_CONNECTION_LIMIT": "1",
        "MYSQL_QUERY_TIMEOUT": "60000",
        "MYSQL_QUEUE_LIMIT": "0",
        "MYSQL_CONNECT_TIMEOUT": "10000",
        "MYSQL_IDLE_TIMEOUT": "60000",
        "MYSQL_MAX_IDLE": "10",
        "MYSQL_ALLOW_EXPLAIN": "true",
        "MYSQL_ALLOW_ANALYZE": "true"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

이러한 고급 옵션을 통해 다음을 제어할 수 있습니다:

MYSQL_CONNECTION_LIMIT: 풀의 최대 연결 수 제어 (기본값: 1)
MYSQL_QUEUE_LIMIT: 대기열에 넣을 최대 연결 요청 수 설정 (기본값: 0, 무제한)
MYSQL_CONNECT_TIMEOUT: 연결 타임아웃을 밀리초 단위로 조정 (기본값: 10000)
MYSQL_QUERY_TIMEOUT: 쿼리 타임아웃을 밀리초 단위로 조정 (기본값: 60000 = 60초)
MYSQL_IDLE_TIMEOUT: 연결이 해제되기 전까지 유휴 상태로 있을 수 있는 시간 (밀리초 단위)
MYSQL_MAX_IDLE: 풀에 유지할 최대 유휴 연결 수 설정
MYSQL_ALLOW_EXPLAIN: EXPLAIN 쿼리 허용 여부 (기본값: true)
MYSQL_ALLOW_ANALYZE: ANALYZE 쿼리 허용 여부 (기본값: true)

테스트

서버에는 MySQL 설정으로 기능을 확인하는 테스트 스크립트가 포함되어 있습니다:

1. 테스트 데이터베이스 설정

이 스크립트는 테스트 데이터베이스, 테이블 및 샘플 데이터를 생성합니다:

# MySQL 자격 증명을 환경 변수로 설정
export MYSQL_HOST=localhost
export MYSQL_PORT=3306
export MYSQL_USER=your_username
export MYSQL_PASSWORD=your_password

# 설정 스크립트 실행
npm run test:setup

2. MCP 도구 테스트

이 스크립트는 테스트 데이터베이스에 대해 각 MCP 도구를 테스트합니다:

# MySQL 자격 증명을 환경 변수로 설정
export MYSQL_HOST=localhost
export MYSQL_PORT=3306
export MYSQL_USER=your_username
export MYSQL_PASSWORD=your_password
export MYSQL_DATABASE=mcp_test_db

# 도구 테스트 스크립트 실행
npm run test:tools

3. 모든 테스트 실행

설정 및 도구 테스트를 모두 실행하려면:

# MySQL 자격 증명을 환경 변수로 설정
export MYSQL_HOST=localhost
export MYSQL_PORT=3306
export MYSQL_USER=your_username
export MYSQL_PASSWORD=your_password

# 모든 테스트 실행
npm test

실제 사용 예제

Kiro IDE에서 사용하기

Kiro IDE에서 이 MCP 서버를 사용하는 예제:

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["@cano721/mysql-mcp-server@latest"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "4307",
        "MYSQL_USER": "developer"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

IntelliJ Copilot에서 사용하기

IntelliJ IDEA의 GitHub Copilot에서 MCP 서버를 사용하려면:

npx 사용 시:

{
  "servers": {
    "mysql": {
      "command": "npx",
      "args": ["@cano721/mysql-mcp-server@latest"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "4307",
        "MYSQL_USER": "developer"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

전역 설치 후 사용 시:

{
  "servers": {
    "mysql": {
      "command": "mysql-mcp-server",
      "args": [],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "4307",
        "MYSQL_USER": "developer"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Cursor IDE에서 사용하기

Cursor IDE에서 MCP 서버를 사용하려면 .cursor/mcp.json 파일을 생성하세요:

{
  "servers": [
    {
      "name": "mysql",
      "type": "command",
      "command": "npx",
      "arguments": ["@cano721/mysql-mcp-server@latest"],
      "environment": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "4307",
        "MYSQL_USER": "developer"
      }
    }
  ]
}

테스트 결과

이 MCP 서버는 다음과 같은 실제 환경에서 테스트되었습니다:

✅ 데이터베이스 목록 조회: 38개의 데이터베이스 성공적으로 조회
✅ 테이블 목록 조회: MySQL 시스템 데이터베이스의 40개 테이블 조회
✅ 테이블 스키마 조회: user 테이블의 46개 컬럼 정보 조회
✅ SQL 쿼리 실행: 사용자 정보 조회 쿼리 성공적으로 실행
✅ EXPLAIN 쿼리: 쿼리 실행 계획 분석 지원
✅ SHOW 명령어: 데이터베이스 메타데이터 조회 지원

문제 해결

빠른 해결책:

문제가 발생하면:

서버 로그에서 오류 메시지 확인
MySQL 자격 증명 및 연결 세부 정보 확인
MySQL 사용자에게 적절한 권한이 있는지 확인
쿼리가 읽기 전용이고 올바르게 형식화되었는지 확인

일반적인 오류

연결 오류: MYSQL_HOST, MYSQL_PORT, MYSQL_USER 환경 변수 확인
권한 오류: MySQL 사용자에게 데이터베이스 접근 권한이 있는지 확인
쿼리 오류: SELECT, SHOW, DESCRIBE, EXPLAIN 문만 사용 가능

npx 관련 문제

0. Node.js 버전 확인 (가장 중요!)

# Node.js 버전 확인 (18.0.0 이상 필요)
node --version

# npm 버전 확인
npm --version

Node.js 18 미만이면 다음 오류가 발생할 수 있습니다:

ES modules 지원 문제
최신 JavaScript 기능 미지원
의존성 패키지 호환성 문제

Node.js 업데이트 방법:

방법 1: 공식 웹사이트에서 다운로드 (권장)

https://nodejs.org/ 방문
LTS 버전 (Long Term Support) 다운로드
설치 프로그램 실행
터미널 재시작 후 버전 확인: node --version

방법 2: nvm 사용 (개발자 권장)

# nvm 설치 (macOS/Linux)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 터미널 재시작 후
nvm install --lts        # 최신 LTS 버전 설치
nvm use --lts           # LTS 버전 사용
nvm alias default lts/* # 기본값으로 설정

방법 3: Homebrew 사용 (macOS)

# Homebrew로 Node.js 업데이트
brew install node

# 또는 기존 설치가 있다면
brew upgrade node

방법 4: 패키지 매니저 사용 (Linux)

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# CentOS/RHEL/Fedora
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

방법 5: Windows

https://nodejs.org/ 에서 Windows Installer 다운로드
또는 Chocolatey 사용: choco install nodejs
또는 Scoop 사용: scoop install nodejs

Node.js 업데이트 후 설정:

# 1. 터미널/명령 프롬프트 재시작 (중요!)

# 2. 버전 확인
node --version  # v18.0.0 이상인지 확인
npm --version   # 8.0.0 이상인지 확인

# 3. npm 캐시 클리어 (권장)
npm cache clean --force

# 4. MCP 서버 테스트
npx @cano721/mysql-mcp-server@latest

# 5. 환경 변수 설정 후 테스트
export MYSQL_HOST=localhost
export MYSQL_PORT=4307
export MYSQL_USER=developer
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx @cano721/mysql-mcp-server

주의사항:

Node.js 업데이트 후 반드시 터미널을 재시작하세요
IDE(IntelliJ, VSCode 등)도 재시작해야 새 Node.js 버전을 인식합니다
기존에 전역 설치한 패키지들은 재설치가 필요할 수 있습니다

1. npx 캐시 문제

# 최신 버전 강제 사용
npx --yes @cano721/mysql-mcp-server@latest

# npm 캐시 클리어
npm cache clean --force

2. 환경 변수 전달 문제

MCP 설정에서 환경 변수가 제대로 설정되었는지 확인:

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["@cano721/mysql-mcp-server@latest"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "4307",
        "MYSQL_USER": "developer"
      }
    }
  }
}

3. Node.js PATH 문제

# Node.js 경로 확인
which node
which npx

# PATH에 Node.js 추가 (필요시)
export PATH="/path/to/node/bin:$PATH"

4. 대안: 전역 설치 사용

npx가 계속 문제가 되면 전역 설치 후 직접 실행:

npm install -g @cano721/mysql-mcp-server

그 후 MCP 설정에서:

{
  "mcpServers": {
    "mysql": {
      "command": "mysql-mcp-server",
      "args": [],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "4307",
        "MYSQL_USER": "developer"
      }
    }
  }
}

5. 연결 테스트

터미널에서 직접 테스트:

# 환경 변수 설정 후 테스트
export MYSQL_HOST=localhost
export MYSQL_PORT=4307
export MYSQL_USER=developer

# MCP 서버 테스트
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx @cano721/mysql-mcp-server

변경 이력

전체 변경 이력은 CHANGELOG.md를 참조하세요.

최근 버전

| 버전 | 날짜 | 주요 변경 사항 | |------|------|---------------| | 0.10.0 | 2025-01-09 | get_related_tables 패턴 매칭 제거, FK 제약조건만 사용 | | 0.9.5 | 2025-01-09 | 쿼리 타임아웃 설정 가능 (MYSQL_QUERY_TIMEOUT, 기본값 60초) | | 0.9.4 | 2025-01-09 | get_related_tables 성능 최적화 (O(n) → O(1) 쿼리, 타임아웃 해결) | | 0.9.3 | 2025-01-09 | 모든 도구 description에 한글 키워드 추가 (한글 질문 인식 개선) | | 0.9.2 | 2025-01-09 | get_related_tables 응답에서 constraint_name 필드 제거 | | 0.9.1 | 2025-01-09 | get_related_tables 응답 크기 최적화 (포맷 변환은 LLM이 수행) | | 0.9.0 | 2025-01-09 | get_related_tables 응답 구조 개선 및 최적화 | | 0.8.0 | 2025-01-09 | get_related_tables에 패턴 매칭 옵션 추가, depth 제한 제거 | | 0.7.0 | 2025-01-09 | get_related_tables 도구 추가 (FK 기반 연관 테이블 depth별 조회) | | 0.6.0 | 2025-01-09 | analyze_table → analyze_query로 변경, @latest 태그 문서 추가 | | 0.5.0 | 2025-01-09 | explain_query, analyze_table 전용 도구 추가 | | 0.4.0 | 2025-01-09 | EXPLAIN/ANALYZE 지원, 연결 풀 기본값 1로 변경 | | 0.3.0 | 2025-01-09 | Node.js 18+ 요구사항, 문제 해결 가이드 추가 | | 0.2.0 | 2025-01-09 | IntelliJ, Cursor, Kiro IDE 설정 예제 추가 | | 0.1.0 | 2025-01-09 | 초기 릴리스 |

라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다 - 자세한 내용은 LICENSE 파일을 참조하세요.

기여

기여를 환영합니다! 이슈를 제출하거나 풀 리퀘스트를 보내주세요.

지원

문제가 있거나 질문이 있으시면 GitHub Issues에서 이슈를 생성해주세요.

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

MySQL 데이터베이스 접근 MCP 서버 (@cano721/mysql-mcp-server)

📋 목차

보안 기능

요구사항

설치

방법 1: npx 사용 (대부분의 MCP 클라이언트에서 권장)

방법 2: 전역 설치 (npx가 안 될 때 권장)

방법 3: 소스에서 빌드

방법 4: Smithery를 통한 설치

2. 환경 변수 설정

3. MCP 설정에 추가

npx 사용 시:

전역 설치 후 사용 시:

소스에서 빌드한 경우:

사용 가능한 도구

list_databases

list_tables

describe_table

execute_query

explain_query

analyze_query

get_related_tables

고급 연결 풀 설정

테스트

1. 테스트 데이터베이스 설정

2. MCP 도구 테스트

3. 모든 테스트 실행

실제 사용 예제

Kiro IDE에서 사용하기

IntelliJ Copilot에서 사용하기

npx 사용 시:

전역 설치 후 사용 시:

Cursor IDE에서 사용하기

테스트 결과

문제 해결

일반적인 오류

npx 관련 문제

0. Node.js 버전 확인 (가장 중요!)

방법 1: 공식 웹사이트에서 다운로드 (권장)

방법 2: nvm 사용 (개발자 권장)

방법 3: Homebrew 사용 (macOS)

방법 4: 패키지 매니저 사용 (Linux)

방법 5: Windows

1. npx 캐시 문제

2. 환경 변수 전달 문제

3. Node.js PATH 문제

4. 대안: 전역 설치 사용

5. 연결 테스트

변경 이력

최근 버전

라이선스

기여

지원