MySQL MCP Server

Claude Code에서 MySQL 데이터베이스에 접근하기 위한 읽기 전용 MCP(Model Context Protocol) 서버입니다.

특징

• 읽기 전용: SELECT, SHOW, DESCRIBE, EXPLAIN 쿼리만 허용
• 안전한 연결: Connection Pool 사용 (최대 5개 연결)
• 6가지 도구 제공: 쿼리 실행, 테이블 목록, 스키마 조회, 인덱스 확인, DDL 조회, 실행 계획 분석

설치

npm install @ahngbeom/mysql-mcp-server

Claude Code 설정

~/.claude.json 또는 프로젝트의 .mcp.json에 추가:

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["@ahngbeom/mysql-mcp-server"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_user",
        "MYSQL_PASS": "your_password",
        "MYSQL_DB": "your_database"
      }
    }
  }
}

환경 변수

변수	설명	기본값
MYSQL_HOST	MySQL 호스트	localhost
MYSQL_PORT	MySQL 포트	3306
MYSQL_USER	사용자 이름	root
MYSQL_PASS	비밀번호	(없음)
MYSQL_DB	데이터베이스 이름	mysql

제공 도구

도구	설명	예시
query	읽기 전용 SQL 쿼리 실행	SELECT * FROM users LIMIT 10
list_tables	데이터베이스의 모든 테이블 조회	-
describe_table	테이블 구조 (컬럼, 타입, 키) 확인	users
show_indexes	테이블의 인덱스 정보 조회	users
show_create_table	CREATE TABLE 문 확인	users
explain	쿼리 실행 계획 분석	SELECT * FROM users WHERE id = 1

보안

• INSERT, UPDATE, DELETE, DROP 등 쓰기 쿼리는 차단됩니다
• 프로덕션 환경에서는 읽기 전용 DB 계정 사용을 권장합니다

라이선스

MIT