local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables secure connections to local MySQL databases, supporting all types of SQL queries (SELECT, INSERT, UPDATE, DELETE, etc.) through natural language interaction

Claude Desktop용 SQL MCP 서버

Claude Desktop을 통해 로컬 MySQL 데이터베이스에 대한 자연어 인터페이스를 제공합니다. 이 MCP(기계 통신 프로토콜) 서버를 통해 Claude는 로컬 MySQL 데이터베이스에서 SQL 쿼리를 실행하여 자연어를 사용하여 데이터베이스와 상호 작용할 수 있습니다.

특징

Claude를 통한 자연어에서 SQL 쿼리로 변환
로컬 MySQL 데이터베이스에 대한 보안 연결
여러 데이터베이스 지원
데이터 일관성을 위한 트랜잭션 관리
더 나은 성능을 위한 연결 풀링
모든 유형의 SQL 쿼리(SELECT, INSERT, UPDATE, DELETE 등) 지원

필수 조건

Python 3.8 이상
MySQL 서버가 설치되고 실행 중입니다.
클로드 데스크톱 애플리케이션
가상 환경(권장)

설치

이 저장소를 복제하세요:

지엑스피1

가상 환경을 만들고 활성화하세요.

# For macOS/Linux
python -m venv venv
source venv/bin/activate

# For Windows
python -m venv venv
venv\Scripts\activate

종속성 설치:

pip install -r requirements.txt

MySQL 자격 증명을 사용하여 프로젝트 루트에 .env 파일을 만듭니다.

MYSQL_HOST=localhost
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password

run.sh 에서 디렉토리 경로를 업데이트합니다.

# Open run.sh and replace this line:
cd /Users/yourname/code/sql-mcp
# with your actual project directory path, for example:
cd /Users/yourname/projects/mysql-mcp

실행 스크립트를 실행 가능하게 만듭니다.

chmod +x run.sh

Claude Desktop의 구성

Claude Desktop의 MCP 구성을 엽니다.
다음 구성을 추가합니다.

{
  "sql": {
    "command": "/absolute/path/to/your/mysql-mcp/run.sh"
  }
}

/absolute/path/to/your/mysql-mcp 프로젝트 디렉토리의 실제 절대 경로로 바꾸세요.

용법

구성이 완료되면 Claude Desktop을 통해 자연어를 사용하여 데이터베이스와 상호 작용할 수 있습니다. 예:

데이터베이스 선택 및 테이블 생성:

Use the 'employees' database and create a table for storing employee information with fields for name, email, and department.

데이터 삽입:

Insert a new employee named John Doe with email john.doe@example.com in the Engineering department.

데이터 쿼리:

Show me all employees in the Engineering department.

중요 참고 사항

run.sh 스크립트와 Claude Desktop 구성에서는 항상 절대 경로를 사용하세요.
MCP 서버를 사용하기 전에 MySQL 서버가 실행 중인지 확인하세요.
.env 파일을 안전하게 보관하고 버전 제어에 커밋하지 마십시오.
MCP 서버는 기본 풀 크기가 5개인 연결 풀링을 사용합니다.

문제 해결

"연결 거부" 오류가 발생하면 MySQL 서버가 실행 중인지 확인하세요.
인증 오류가 발생하면 .env 파일에서 자격 증명을 확인하세요.
권한 오류의 경우 MySQL 사용자에게 수행하려는 작업에 대한 적절한 권한이 있는지 확인하십시오.

보안 고려 사항

.env 파일에 중요한 자격 증명을 저장합니다.
적절한 권한이 있는 MySQL 사용자를 사용하세요(root 사용은 피하세요)
가상 환경과 종속성을 최신 상태로 유지하세요
로컬 호스트가 아닌 MySQL 서버에 액세스하는 경우 네트워크 보안을 고려하세요.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Claude가 로컬 MySQL 데이터베이스에서 SQL 쿼리를 실행하고 자연어를 사용하여 데이터베이스와 상호 작용할 수 있도록 하는 자연어 인터페이스입니다.

Related Resources

Reddit Discussion about this server

SQL MCP Server for Claude Desktop