MySQL MCP Server

이 프로젝트는 Smithery의 Model Context Protocol (MCP)을 사용하여 MySQL 데이터베이스와 상호작용하는 서버입니다.

npx -y @smithery/cli install @aqaranewbiz/mysql-aqaranewbiz --client claude

{ "mcpServers": { "mysql": { "command": "npx", "args": ["-y", "@aqaranewbiz/mysql-aqaranewbiz"], "env": { "MYSQL_HOST": "your_host", "MYSQL_USER": "your_user", "MYSQL_PASSWORD": "your_password", "MYSQL_DATABASE": "your_database" } } } }

Establish connection to MySQL database using provided credentials.

use_mcp_tool({ server_name: "mysql", tool_name: "connect_db", arguments: { host: "localhost", user: "your_user", password: "your_password", database: "your_database" } });

Execute SELECT queries with optional prepared statement parameters.

use_mcp_tool({ server_name: "mysql", tool_name: "query", arguments: { sql: "SELECT * FROM users WHERE id = ?", params: [1] } });

Execute INSERT, UPDATE, or DELETE queries with optional prepared statement parameters.

use_mcp_tool({ server_name: "mysql", tool_name: "execute", arguments: { sql: "INSERT INTO users (name, email) VALUES (?, ?)", params: ["John Doe", "john@example.com"] } });

List all tables in the connected database.

use_mcp_tool({ server_name: "mysql", tool_name: "list_tables", arguments: {} });

use_mcp_tool({ server_name: "mysql", tool_name: "describe_table", arguments: { table: "users" } });

- MySQL 데이터베이스 연결 및 쿼리 실행
- MCP 프로토콜을 통한 표준화된 API 제공
- FastAPI 기반의 RESTful API 엔드포인트
- 환경 변수를 통한 설정 관리

MYSQL_HOST=your_mysql_host MYSQL_USER=your_mysql_user MYSQL_PASSWORD=your_mysql_password MYSQL_DATABASE=your_database_name

# Windows python -m venv venv venv\Scripts\activate # macOS/Linux python3 -m venv venv source venv/bin/activate

docker run -e MYSQL_HOST=host -e MYSQL_USER=user -e MYSQL_PASSWORD=pass -e MYSQL_DATABASE=db mysql-mcp-server

# 개발용 의존성 설치 pip install -r requirements-dev.txt # 필요한 경우 생성 # 코드 포맷팅 및 린팅 설정 pip install black flake8

@MCP-Server-for-Smithery/ ├── mcp_server.py # 메인 서버 코드 ├── requirements.txt # Python 의존성 ├── Dockerfile # Docker 설정 ├── .env # 환경 변수 (템플릿) └── tests/ # 테스트 코드

- mcp_server.py에 새로운 도구 추가
- 필요한 의존성requirements.txt에 추가
- 테스트 코드 작성
- Docker 이미지 재빌드 (Docker 사용 시)

- MySQL 서버가 실행 중인지 확인
- 환경 변수가 올바르게 설정되었는지 확인
- 로컬 설치 시 MySQL 클라이언트 라이브러리가 설치되어 있는지 확인

- SQL 구문 검사
- 데이터베이스 권한 확인
- 로컬 설치 시 MySQL 커넥터 버전 확인

서버는 기본적으로 로그를 표준 출력에 기록합니다. 로컬 설치 시 로그 레벨을 조정하려면:
- 이슈 생성
- 브랜치 생성 (git checkout -b feature/AmazingFeature)
- 변경사항 커밋 (git commit -m 'Add some AmazingFeature')
- 브랜치 푸시 (git push origin feature/AmazingFeature)
- Pull Request 생성

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은LICENSE파일을 참조하세요.

Multi-database agent access (PostgreSQL, SQLite, MySQL, Oracle, SQL Server) with batch queries, pre-configured connections, and SQLGlot-enforced read-only safety

A read-only MCP server for MySQL, enabling LLMs to query live data using the CData JDBC Driver.

Database MCP server for MySQL, MariaDB, PostgreSQL & SQLite

A single-binary MCP server for MySQL, MariaDB, PostgreSQL, and SQLite

A Model Context Protocol (MCP) server that provides multi-database query execution capabilities with support for SQLite, PostgreSQL, and MySQL databases. Includes a built-in Web UI for managing database connections.

Allows Claude AI to interact directly with MySQL databases.

Update various databases (PostgreSQL, MySQL, MongoDB, SQLite) using data from CSV and Excel files.

Enables AI assistants to interact with various databases through JDBC connections.

An MCP server for retrieving data from a MariaDB database.

Access and manage MariaDB or MySQL databases using an MCP server.