designcomputer/mysql_mcp_server

해결하는 문제

이 프로젝트는 AI 애플리케이션(예: Claude Desktop 또는 Claude Code)이 MySQL 데이터베이스와 안전하게 상호작용할 수 있도록 구조화된 인터페이스를 제공합니다. 데이터베이스 탐색 및 분석을 위한 제어된 도구와 프롬프트를 제공함으로써 AI가 데이터에 제한 없이 위험한 접근을 하지 못하도록 방지합니다.

작동 방식

Model Context Protocol (MCP)를 구현하여, AI 클라이언트가 표준 입력/출력(STDIO) 또는 Streamable HTTP(SSE)를 통해 서버와 통신할 수 있습니다. 서버는 환경 변수를 사용하여 MySQL에 연결하며, 다음 세 가지 주요 도구를 제공합니다:

• execute_sql: 표준 SQL 쿼리(SELECT, SHOW, DESCRIBE 및 DML 작업)를 실행합니다.
• get_schema_info: 특정 테이블의 컬럼, 타입, 제약 조건에 대한 상세한 메타데이터를 가져옵니다.
• get_table_sample: AI가 테이블 내용을 이해하는 데 도움이 되는 작은 대표 샘플 데이터를 가져옵니다.

또한 데이터베이스를 체계적으로 탐색하거나 특정 테이블을 심층 분석하는 등의 일반적인 워크플로우용 사전 정의된 프롬프트도 포함되어 있습니다.

대상 사용자

각 프로젝트마다 맞춤형 통합 코드를 작성하지 않고도 AI 에이전트가 MySQL 데이터베이스를 안전하게 쿼리하고 분석하고 싶은 개발자 및 데이터 분석가를 위한 것입니다.

주요 특징

• 보안 연결: 원격 데이터베이스 접근을 위한 SSL/TLS 및 SSH 터널링을 지원합니다.
• 다중 데이터베이스 모드: 특정 데이터베이스가 구성되지 않은 경우 database.table 표기법을 사용해 여러 데이터베이스를 운영할 수 있습니다.
• 유연한 전송 방식: 로컬(STDIO) 및 원격(SSE) 배포 모드를 모두 지원합니다.
• SQL 인젝션 방지: 테이블 및 데이터베이스 이름에 대해 엄격한 식별자 검증을 수행합니다.
• 가이드된 워크플로우: 데이터베이스 탐색 및 테이블 분석용 내장 MCP 프롬프트를 제공합니다.