👁 테스트
👁 PyPI - 다운로드
👁 대장간 배지

MySQL MCP 서버

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

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

특징

• 사용 가능한 MySQL 테이블을 리소스로 나열합니다.

• 표의 내용을 읽어보세요

• 적절한 오류 처리를 통해 SQL 쿼리 실행

• 환경 변수를 통한 안전한 데이터베이스 액세스

• 종합 로깅

Related MCP server: MySQL MCP Server

설치

수동 설치

지엑스피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 구현이 작동하려면 데이터베이스 액세스가 필요합니다. 보안을 위해:

1. 최소한의 권한이 있는 전담 MySQL 사용자 생성

2. 루트 자격 증명이나 관리 계정을 사용하지 마십시오.

3. 필요한 작업에만 데이터베이스 액세스를 제한합니다.

4. 감사 목적으로 로깅을 활성화합니다 .

5. 데이터베이스 접근에 대한 정기적인 보안 검토

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

• 제한된 MySQL 사용자 생성

• 적절한 권한 설정

• 데이터베이스 액세스 모니터링

• 보안 모범 사례

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

특허

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

기여하다

1. 저장소를 포크하세요

2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )

3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )

4. 브랜치에 푸시( git push origin feature/amazing-feature )

5. 풀 리퀘스트 열기

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• execute_sqlA
• get_schema_infoA
• get_table_sampleA