hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Enables secure interaction with MySQL databases, allowing for listing tables, reading data, and executing SQL queries through a controlled interface for database exploration and analysis.

MySQL MCP 서버

MySQL 데이터베이스와의 안전한 상호작용을 지원하는 모델 컨텍스트 프로토콜(MCP) 구현입니다. 이 서버 구성 요소는 AI 애플리케이션(호스트/클라이언트)과 MySQL 데이터베이스 간의 통신을 원활하게 하여, 제어된 인터페이스를 통해 데이터베이스 탐색 및 분석을 더욱 안전하고 체계적으로 수행합니다.

참고 : MySQL MCP 서버는 독립형 서버로 사용하도록 설계된 것이 아니라 AI 애플리케이션과 MySQL 데이터베이스 간의 통신 프로토콜 구현으로 설계되었습니다.

특징

사용 가능한 MySQL 테이블을 리소스로 나열합니다.
표의 내용을 읽어보세요
적절한 오류 처리를 통해 SQL 쿼리 실행
환경 변수를 통한 안전한 데이터베이스 액세스
종합 로깅

설치

수동 설치

지엑스피1

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 MySQL MCP 서버를 자동으로 설치하려면:

npx -y @smithery/cli install mysql-mcp-server --client claude

구성

다음 환경 변수를 설정하세요.

MYSQL_HOST=localhost     # Database host
MYSQL_PORT=3306         # Optional: Database port (defaults to 3306 if not specified)
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database

용법

클로드 데스크톱과 함께

claude_desktop_config.json 에 다음을 추가하세요:

{
  "mcpServers": {
    "mysql": {
      "command": "uv",
      "args": [
        "--directory", 
        "path/to/mysql_mcp_server",
        "run",
        "mysql_mcp_server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

Visual Studio Code를 사용하여

mcp.json 에 다음을 추가하세요:

{
  "servers": {
      "mysql": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "--from",
                "mysql-mcp-server",
                "mysql_mcp_server"
            ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
  }
}

참고: 이 기능을 사용하려면 uv를 설치해야 합니다.

MCP Inspector를 사용한 디버깅

MySQL MCP 서버는 단독으로 실행하거나 Python 명령줄에서 직접 실행하도록 설계되지 않았지만 MCP Inspector를 사용하여 디버깅할 수 있습니다.

MCP Inspector는 MCP 구현을 테스트하고 디버깅하는 편리한 방법을 제공합니다.

# Install dependencies
pip install -r requirements.txt
# Use the MCP Inspector for debugging (do not run directly with Python)

MySQL MCP 서버는 Claude Desktop과 같은 AI 애플리케이션과 통합되도록 설계되었으며 독립형 Python 프로그램으로 직접 실행하면 안 됩니다.

개발

# Clone the repository
git clone https://github.com/yourusername/mysql_mcp_server.git
cd mysql_mcp_server
# Create virtual environment
python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows
# Install development dependencies
pip install -r requirements-dev.txt
# Run tests
pytest

보안 고려 사항

환경 변수나 자격 증명을 커밋하지 마십시오.
최소한의 필수 권한이 있는 데이터베이스 사용자를 사용하세요
프로덕션 사용을 위해 쿼리 허용 목록을 구현하는 것을 고려하세요.
모든 데이터베이스 작업을 모니터링하고 기록합니다.

보안 모범 사례

이 MCP 구현이 작동하려면 데이터베이스 액세스가 필요합니다. 보안을 위해:

최소한의 권한이 있는 전담 MySQL 사용자 생성
루트 자격 증명이나 관리 계정을 사용하지 마십시오.
필요한 작업에만 데이터베이스 액세스를 제한합니다.
감사 목적으로 로깅을 활성화합니다 .
데이터베이스 접근에 대한 정기적인 보안 검토

자세한 지침은 MySQL 보안 구성 가이드를 참조하세요.

제한된 MySQL 사용자 생성
적절한 권한 설정
데이터베이스 액세스 모니터링
보안 모범 사례

⚠️ 중요: 데이터베이스 액세스를 구성할 때는 항상 최소 권한 원칙을 따르세요.

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

기여하다

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

execute_sql

AI 도우미가 제어된 인터페이스를 통해 테이블을 나열하고, 데이터를 읽고, SQL 쿼리를 실행할 수 있도록 하여 데이터베이스 탐색 및 분석을 보다 안전하고 체계적으로 만들어줍니다.

MySQL MCP Server