benborla/mcp-server-mysql

해결하는 문제

이 프로젝트는 Claude와 같은 대규모 언어 모델(LLM)과 MySQL 데이터베이스 사이의 다리를 제공하여 AI 에이전트가 구조화된 데이터에 직접 접근할 수 있도록 합니다. AI 에이전트가 실시간 데이터베이스 스키마에 직접 접근할 수 없고, 데이터 기반 질문에 답하기 위해 SQL 쿼리를 실행할 수 없는 문제를 해결합니다.

작동 방식

Model Context Protocol (MCP)를 구현하여 AI 모델이 외부 도구 및 리소스에 접근하는 방식을 표준화합니다. 서버는 SQL을 실행하기 위한 mysql_query 도구와 데이터베이스 스키마 및 컬럼 메타데이터를 제공하는 mysql://tables 리소스를 노출하여 모델이 데이터베이스 구조를 기반으로 쿼리를 작성하고 실행할 수 있도록 합니다.

대상 사용자

MySQL 데이터베이스를 AI 에이전트(Claude Code 또는 Claude Desktop 등)와 통합하여 데이터 검색 및 데이터베이스 검사 작업을 자동화하고자 하는 개발자 및 데이터 분석가를 위한 것입니다.

주요 기능

• 기본적으로 읽기 전용: 쓰기 작업을 활성화하려면 명시적인 환경 변수 플래그가 필요하여 실수로 데이터를 수정하는 것을 방지합니다.
• SSH 터널 지원: 원격 데이터베이스에 안전하게 연결할 수 있습니다.
• PII 마스킹: 쿼리 결과에서 민감한 데이터를 자동으로 가리켜 개인정보 보호를 강화합니다.
• 다중 DB 모드: 재연결 없이 여러 데이터베이스를 쿼리할 수 있습니다.
• SSL/TLS 지원: 암호화된 연결을 지원하며, mTLS 옵션도 제공합니다.
• 원격 모드: Bearer 토큰 인증을 사용하는 HTTP 전송을 지원합니다.