benborla/mcp-server-mysql

어떤 프로젝트인가요?

핵심 기능

• 01기본적으로 읽기 전용이며, 별도의 플래그로 insert, update, delete 작업을 각각 활성화할 수 있습니다.
• 02MCP 도구와 리소스로 스키마 확인 및 SQL 쿼리 실행 기능을 제공합니다.
• 03원격 데이터베이스를 위한 SSH 터널을 지원합니다.
• 04재접속 없이 여러 데이터베이스를 조회하는 멀티 데이터베이스 모드를 지원합니다.
• 05쿼리 결과의 민감한 값을 자동으로 PII 마스킹합니다.
• 06선택적 mTLS를 지원하는 SSL/TLS 연결과 bearer token 인증을 사용하는 HTTP 원격 모드를 제공합니다.

활용 사례

• Claude Code나 Claude Desktop이 MySQL 스키마를 살펴보고 데이터 관련 질문에 답하도록 합니다.
• AI 어시스턴트에 운영 환경과 유사한 데이터에 대한 안전한 읽기 전용 분석 접근 권한을 제공합니다.
• 로컬 AI 클라이언트에서 SSH 터널을 통해 원격 MySQL 인스턴스를 조회합니다.
• 단일 LLM 세션에서 여러 데이터베이스를 아우르는 분석을 수행합니다.

빠른 시작

1. 1

   Node.js v20 이상과 적절한 권한이 있는 MySQL 사용자가 필요합니다

2. 2

   MySQL 연결 환경 변수를 설정해 Claude Code에 서버를 등록합니다

   claude mcp add mcp_server_mysql -e MYSQL_HOST="127.0.0.1" -e MYSQL_PORT="3306" -e MYSQL_USER="root" -e MYSQL_PASS="your_password" -e MYSQL_DB="your_database" -- npx @benborla29/mcp-server-mysql

사용 전 알아둘 점

• !Node.js v20 이상과 MySQL 5.7 이상 데이터베이스가 필요합니다(8.0 이상 권장).
• !쓰기 작업은 기본적으로 비활성화되어 있으며, 별도의 환경 플래그를 설정해야 활성화할 수 있습니다.

토픽

자주 묻는 질문

mcp-server-mysql은(는) 무엇인가요?

Claude 같은 LLM이 MySQL 데이터베이스에 기본적으로 읽기 전용으로 접근할 수 있게 하는 MCP 서버로, 플래그를 설정하면 쓰기 작업도 허용할 수 있습니다. 이 프로젝트는 MySQL용 Model Context Protocol (MCP)을 구현해 Claude Code나 Claude Desktop 같은 LLM 클라이언트가 데이터베이스 스키마를 살펴보고 MySQL 서버에서 SQL 쿼리를 실행할 수 있게 합니다. 모델이 데이터를 변경하지 않고 탐색할 수 있도록 읽기 전용 모드가 기본으로 설정되어 있으며, insert, update, delete 작업은 각각 환경 변수 플래그를 통해 활성화해야 합니다.

mcp-server-mysql은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

mcp-server-mysql은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

mcp-server-mysql은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. mcp-server-mysql의 마지막 커밋은 2026년 7월 27일입니다.

mcp-server-mysql은(는) 어디에 사용할 수 있나요?

Claude Code나 Claude Desktop이 MySQL 스키마를 살펴보고 데이터 관련 질문에 답하도록 합니다. AI 어시스턴트에 운영 환경과 유사한 데이터에 대한 안전한 읽기 전용 분석 접근 권한을 제공합니다. 로컬 AI 클라이언트에서 SSH 터널을 통해 원격 MySQL 인스턴스를 조회합니다. 단일 LLM 세션에서 여러 데이터베이스를 아우르는 분석을 수행합니다.

mcp-server-mysql는 어떻게 설치하나요?

Node.js v20 이상과 적절한 권한이 있는 MySQL 사용자가 필요합니다 MySQL 연결 환경 변수를 설정해 Claude Code에 서버를 등록합니다: claude mcp add mcp_server_mysql -e MYSQL_HOST="127.0.0.1" -e MYSQL_PORT="3306" -e MYSQL_USER="root" -e MYSQL_PASS="your_password" -e MYSQL_DB="your_database" -- npx @benborla29/mcp-server-mysql

mcp-server-mysql은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/benborla/mcp-server-mysql