Skip to main content
Glama

MySQL MCP Server

by bertshim
GitHub
Python
MIT License
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MySQL MCP Server

MySQL 데이터베이스 관리를 위한 MCP(Model Context Protocol) 서버입니다. FastMCP를 사용하여 개발되었으며, MySQL 데이터베이스의 테이블, 컬럼, 인덱스 정보를 조회하고 데이터를 검색할 수 있습니다.

🚀 주요 기능

📋 테이블 관리

  • 테이블 목록 조회: 현재 데이터베이스의 모든 테이블 정보를 표 형태로 표시
  • 컬럼 정보 조회: 특정 테이블의 컬럼 상세 정보를 표 형태로 표시
  • 인덱스 정보 조회: 테이블에 설정된 인덱스 정보를 표 형태로 표시

🔍 데이터 검색

  • 단일 테이블 검색: 특정 테이블에서 조건에 맞는 데이터 검색
  • 다중 테이블 검색: 여러 테이블을 조인하여 복합 검색 수행
  • 검색 결과 제한: 기본적으로 상위 10개 결과만 표시하여 성능 최적화

⚙️ 시스템 정보

  • 데이터베이스 연결 정보: 서버 버전, 현재 데이터베이스, 연결 상태 등
  • 환경 변수 기반 설정: 안전한 연결 정보 관리

📦 설치 방법

1. 필요한 모듈 설치

pip install -r requirements.txt

2. 환경 변수 설정

.env 파일을 생성하거나 환경 변수를 설정합니다:

# MySQL 연결 설정 export MYSQL_HOST=localhost export MYSQL_PORT=3306 export MYSQL_USER=root export MYSQL_PASSWORD=your_password_here export MYSQL_DATABASE=your_database_name # MCP 서버 설정 export MCP_SERVER_NAME=mysql-mcp export MCP_SERVER_VERSION=1.0.0

또는 env_example.txt 파일을 참고하여 설정하세요.

🎯 사용 방법

1. MCP 서버 실행

python simple_mysql_mcp.py

2. 사용 가능한 도구들

테이블 목록 조회
show_tables()

현재 데이터베이스의 모든 테이블을 표 형태로 표시합니다.

테이블 컬럼 정보 조회
show_table_columns("테이블명")

지정된 테이블의 컬럼 상세 정보를 표 형태로 표시합니다.

테이블 데이터 검색
search_table("테이블명", "검색조건")

예시:

  • search_table("users") - 전체 데이터 조회
  • search_table("users", "age > 25") - 조건에 맞는 데이터 검색
  • search_table("users", "name = 'John'") - 특정 값 검색
다중 테이블 검색
search_multiple_tables(["테이블1", "테이블2"], "조인조건", "검색조건")

예시:

  • search_multiple_tables(["users", "orders"], "users.id = orders.user_id")
  • search_multiple_tables(["users", "orders"], "users.id = orders.user_id", "orders.amount > 100")
인덱스 정보 조회
show_table_indexes("테이블명")

지정된 테이블의 인덱스 정보를 표 형태로 표시합니다.

데이터베이스 정보 조회
get_database_info()

현재 연결된 데이터베이스의 서버 정보와 연결 상태를 표시합니다.

🧪 테스트

기능 테스트를 위해 다음 명령어를 실행하세요:

python test_mysql_mcp.py

테스트는 다음 항목들을 확인합니다:

  • 환경 변수 설정 상태
  • FastMCP 모듈 import
  • MySQL Connector 모듈 import
  • MCP 서버 생성
  • MySQL 연결 상태

🔧 기술 스택

  • Python 3.7+: 메인 프로그래밍 언어
  • FastMCP: MCP 서버 프레임워크
  • MySQL Connector/Python: MySQL 데이터베이스 연결
  • Environment Variables: 설정 관리

📁 파일 구조

simple_mysql_mcp/ ├── simple_mysql_mcp.py # 메인 MCP 서버 파일 ├── requirements.txt # 필요한 Python 모듈 목록 ├── env_example.txt # 환경 변수 설정 예시 ├── test_mysql_mcp.py # 기능 테스트 파일 └── README.md # 이 파일

🚨 주의사항

  1. 보안: 데이터베이스 비밀번호를 코드에 하드코딩하지 마세요.
  2. 권한: MCP 서버가 실행되는 사용자가 MySQL에 접근할 수 있는 권한을 가지고 있어야 합니다.
  3. 연결: MySQL 서버가 실행 중이어야 합니다.
  4. 데이터베이스: MYSQL_DATABASE 환경 변수를 설정하여 사용할 데이터베이스를 지정하세요.

🐛 문제 해결

연결 오류

  • MySQL 서버가 실행 중인지 확인
  • 호스트, 포트, 사용자명, 비밀번호가 올바른지 확인
  • 방화벽 설정 확인

권한 오류

  • MySQL 사용자가 해당 데이터베이스에 접근 권한을 가지고 있는지 확인
  • GRANT 명령어로 권한 부여

모듈 오류

  • pip install -r requirements.txt 실행
  • Python 버전이 3.7 이상인지 확인

📝 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다.

🤝 기여

버그 리포트나 기능 제안은 이슈로 등록해주세요. 풀 리퀘스트도 환영합니다.

MySQL MCP Server - MySQL 데이터베이스 관리를 위한 강력한 MCP 도구

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables interaction with MySQL databases through MCP tools for querying table structures, searching data across single or multiple tables, and managing database information. Built with FastMCP framework for secure database operations using environment-based configuration.

  1. 🚀 주요 기능
    1. 📋 테이블 관리
    2. 🔍 데이터 검색
    3. ⚙️ 시스템 정보
  2. 📦 설치 방법
    1. 1. 필요한 모듈 설치
    2. 2. 환경 변수 설정
  3. 🎯 사용 방법
    1. 1. MCP 서버 실행
    2. 2. 사용 가능한 도구들
  4. 🧪 테스트
    1. 🔧 기술 스택
      1. 📁 파일 구조
        1. 🚨 주의사항
          1. 🐛 문제 해결
            1. 연결 오류
            2. 권한 오류
            3. 모듈 오류
          2. 📝 라이선스
            1. 🤝 기여

              Related MCP Servers

              • MySQL MCP Server

                kevinwatt
                -
                security
                A
                license
                -
                quality
                An MCP server that integrates with MySQL databases, enabling secure read and write operations through LLM-driven interfaces with support for transaction handling and performance monitoring.
                Last updated -
                107
                16
                MIT License

              • MySQL MCP Server

                vitalyDV
                -
                security
                F
                license
                -
                quality
                An MCP server that allows working with MySQL databases by providing tools for executing read-only SQL queries, getting table schemas, and listing database tables.
                Last updated -
                509
                3

              • Python MySQL MCP

                hoonzinope
                -
                security
                F
                license
                -
                quality
                A FastMCP-based server that enables interaction with MySQL databases, supporting client-server communication for querying and analyzing MySQL data.
                Last updated -

              • MySQL MCP Server

                slg1119
                -
                security
                F
                license
                -
                quality
                Provides MySQL database integration for AI assistants and other MCP clients, allowing them to list tables, read table data, and execute SQL queries.
                Last updated -

              View all related MCP servers

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/bertshim/simple_mysql_mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server