Repolode
제출하기
designcomputer

designcomputer/mysql_mcp_server

Claude 같은 AI 어시스턴트가 제한된 도구를 통해 MySQL 데이터베이스를 탐색하고 쿼리할 수 있게 해주는 MCP 서버입니다.

GitHub에서 보기웹사이트
스타
1,408
포크
260
열린 이슈
4
마지막 커밋
10일 전

어떤 프로젝트인가요?

MySQL MCP Server는 Model Context Protocol을 구현해 AI 애플리케이션이 MySQL 데이터베이스에 연결하고 스키마와 데이터를 다룰 수 있게 합니다. 모델에 제한 없는 데이터베이스 접근 권한을 주는 대신 SQL 쿼리 실행, 테이블 스키마 확인, 테이블 행 샘플링을 위한 고정된 도구를 제공합니다.

Claude Desktop, Claude Code, VS Code 같은 로컬 클라이언트에서는 stdio로 실행하고, 원격 배포 환경에서는 Streamable HTTP (SSE)로 실행할 수 있습니다. 연결 설정은 환경 변수로 지정하며, SSL/TLS 모드, 비공개 데이터베이스에 접근하기 위한 SSH 터널링, 단일 데이터베이스를 지정하지 않았을 때 서버의 모든 사용자 데이터베이스에서 동작하는 멀티 데이터베이스 모드를 지원합니다. 로그에서는 비밀번호와 SSH 키를 마스킹합니다.

또한 스키마 확인 및 샘플링 도구를 여러 단계의 워크플로로 묶는 explore_database와 analyze_table 두 가지 안내 프롬프트를 제공합니다. SSE 전송 방식에는 기본 인증 기능이 없으므로, localhost 외부에 공개할 때는 리버스 프록시 뒤에 배치할 것을 권장합니다.

핵심 기능

  • 01MySQL 테이블을 리소스로 나열하고 테이블 내용을 읽습니다
  • 02SELECT, SHOW, DESCRIBE, DML 문을 포함한 SQL 쿼리를 실행합니다
  • 03열 타입, NULL 허용 여부, 기본값, 주석 등의 스키마 정보를 반환합니다
  • 04테이블에서 최대 20개 행을 샘플링합니다
  • 05stdio 및 SSE/HTTP 전송 방식을 지원합니다
  • 06SSH 터널링, SSL/TLS 모드, 멀티 데이터베이스 모드를 제공합니다

활용 사례

  • Claude나 다른 AI 어시스턴트가 데이터베이스 내용에 관한 질문에 답하도록 합니다
  • 쿼리를 작성하기 전에 익숙하지 않은 데이터베이스 스키마를 살펴봅니다
  • AI 도구에 개발 또는 스테이징용 MySQL 인스턴스의 읽기 권한이나 제한된 쓰기 권한을 부여합니다
  • SSH 점프 호스트를 통해 비공개 MySQL 서버에 접근합니다

빠른 시작

  1. 1

    PyPI에서 패키지를 설치합니다

    pip install mysql-mcp-server
  2. 2

    MCP 클라이언트 설정의 env 블록에 MYSQL_HOST, MYSQL_USER, MYSQL_PASSWORD, MYSQL_DATABASE를 설정합니다

  3. 3

    Claude Code CLI에 서버를 등록합니다

    claude mcp add --transport stdio designcomputer-mysql_mcp_server uvx mysql_mcp_server

사용 전 알아둘 점

  • 단일 SQL 문만 지원하며, 여러 문으로 구성된 쿼리는 거부됩니다.
  • SSE 전송에는 기본 인증 기능이 없으므로 localhost 외부에 공개하려면 리버스 프록시가 필요합니다.
  • Claude Desktop과 같은 호스트는 프로젝트의 .env 파일을 불러오지 않으므로, 인증 정보는 MCP 설정에 입력해야 합니다.

포함된 컬렉션

Claude Code용 MCP 서버데이터베이스 MCP 서버Claude Code 도구·스킬·플러그인오픈소스 AI 에이전트 프레임워크와 앱MCP 서버데이터베이스 & SQL 도구

토픽

#mysql#mcp#database#llm#sql#claude#ai-agent#ai#claude-code#mcp-server

자주 묻는 질문

mysql_mcp_server은(는) 무엇인가요?
Claude 같은 AI 어시스턴트가 제한된 도구를 통해 MySQL 데이터베이스를 탐색하고 쿼리할 수 있게 해주는 MCP 서버입니다. MySQL MCP Server는 Model Context Protocol을 구현해 AI 애플리케이션이 MySQL 데이터베이스에 연결하고 스키마와 데이터를 다룰 수 있게 합니다. 모델에 제한 없는 데이터베이스 접근 권한을 주는 대신 SQL 쿼리 실행, 테이블 스키마 확인, 테이블 행 샘플링을 위한 고정된 도구를 제공합니다.
mysql_mcp_server은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
mysql_mcp_server은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
mysql_mcp_server은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. mysql_mcp_server의 마지막 커밋은 2026년 10월 28일입니다.
mysql_mcp_server은(는) 어디에 사용할 수 있나요?
Claude나 다른 AI 어시스턴트가 데이터베이스 내용에 관한 질문에 답하도록 합니다 쿼리를 작성하기 전에 익숙하지 않은 데이터베이스 스키마를 살펴봅니다 AI 도구에 개발 또는 스테이징용 MySQL 인스턴스의 읽기 권한이나 제한된 쓰기 권한을 부여합니다 SSH 점프 호스트를 통해 비공개 MySQL 서버에 접근합니다
mysql_mcp_server는 어떻게 설치하나요?
PyPI에서 패키지를 설치합니다: pip install mysql-mcp-server MCP 클라이언트 설정의 env 블록에 MYSQL_HOST, MYSQL_USER, MYSQL_PASSWORD, MYSQL_DATABASE를 설정합니다 Claude Code CLI에 서버를 등록합니다: claude mcp add --transport stdio designcomputer-mysql_mcp_server uvx mysql_mcp_server
mysql_mcp_server은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/designcomputer/mysql_mcp_server

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트