Skip to main content
Glama
Ahngbeom

MySQL MCP Server

by Ahngbeom

MySQL MCP Server

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

특징

  • 읽기 전용: SELECT, SHOW, DESCRIBE, EXPLAIN 쿼리만 허용

  • 안전한 연결: Connection Pool 사용 (최대 5개 연결)

  • 6가지 도구 제공: 쿼리 실행, 테이블 목록, 스키마 조회, 인덱스 확인, DDL 조회, 실행 계획 분석

Related MCP server: mysql-mcp

설치

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server implementation that enables Claude to execute read-only queries against MariaDB databases and explore database schemas through natural language.
    20
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A lightweight MCP server providing safe, read-only access to MySQL databases. It enables users to query multiple MySQL instances securely while preventing write operations.
    630 npm
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for MySQL/MariaDB/Aurora MySQL that enables executing SQL queries, explaining query plans, inspecting schema, checking health, and running diagnostic playbooks through Claude.
    Apache 2.0