MySQL MCP Server

MySQL MCP Server

MySQL Model Context Protocol(MCP) 서버는 로컬 환경의 MySQL 데이터베이스에 연결하여 대규모 언어 모델(LLM)이 SQL 쿼리를 실행할 수 있도록 하는 도구입니다.

요구사항

• Node.js : 20.0.0 이상
• MySQL : 5.7 이상의 MySQL 또는 MariaDB 서버

기능

• MySQL 쿼리 실행 : LLM에서 SQL 쿼리를 직접 실행
• 데이터베이스 정보 검색 : 데이터베이스 목록, 테이블 목록, 테이블 구조 확인
• MCP 준수 : Model Context Protocol을 지원하고 LLM과 통합 가능
• stdio 통신 : 표준 입출력을 사용하여 LLM과 통신, 포트 바인딩 없음
• 연결 정보 저장 : 데이터베이스 연결 정보를 로컬로 저장하고 재사용

설치 및 사용 방법

NPX에서 임시 실행

옵션

연결 정보 저장 및 재사용

MySQL MCP Server는 성공적으로 연결된 데이터베이스의 정보를 로컬로 저장합니다. 이렇게하면 다음에 .mysql-mcp-connections.json 때 연결 정보를 자동으로 다시 사용할 수 있습니다.

연결 정보에는 다음이 포함됩니다.

• 호스트 이름
• 포트 번호
• 사용자 이름
• 비밀번호
• 데이터베이스 이름(설정된 경우)

구성 파일 사용

구성 파일(JSON 형식)을 사용하여 연결 정보를 설정할 수도 있습니다.

구성 파일을 사용하는 경우 :

통신 방식

MySQL MCP Server는 MCP(Model Context Protocol)에 준거한 「stdio」모드로 동작합니다.

1. 포트 충돌 방지 : 특정 포트를 사용하지 않기 때문에 포트 충돌 문제가 발생하지 않습니다.
2. 향상된 보안: 네트워크 통신을 사용하지 않으므로 네트워크 수준 공격 위험을 줄입니다.
3. 간단한 프로세스 간 통신 : LLM과의 통신 단순화

주의점

• stdio 모드에서는 JSON 형식의 메시지를 교환합니다.
• 한 줄에 하나의 JSON 메시지를 보내야합니다.
• 오류 정보와 연결 로그는 표준 오류(stderr)로 출력됩니다.

제공되는 MCP 도구

데이터베이스 연결 관리

SQL 쿼리 작업

연결 관리 기능

MySQL MCP Server를 사용하면 서버 시작과 데이터베이스 연결을 분리할 수 있습니다.

1. 연결 정보 없이 부팅 : 서버는 데이터베이스 연결 정보 없이 부팅 가능
2. 여러 데이터베이스에 연결 : 서버를 시작한 후 다른 데이터베이스로 연결을 전환할 수 있습니다.
3. 간단한 설치 : npx -y https://github.com/yuki777/mysql-mcp-server 에서만 실행 가능

연결 관리 사용 방법

1. 자동 연결 없이 서버 시작 :
   npx -y https://github.com/yuki777/mysql-mcp-server
2. 연결 도구를 사용하여 데이터베이스에 연결 :
   { "type": "tool_call", "request_id": "req_1", "tool": "connect_database", "arguments": { "host": "localhost", "port": 3306, "user": "root", "password": "your_password", "database": "your_db" } }
3. 연결 상태 확인 :
   { "type": "tool_call", "request_id": "req_2", "tool": "get_connection_status", "arguments": {} }
4. 연결 끊기 :
   { "type": "tool_call", "request_id": "req_3", "tool": "disconnect_database", "arguments": {} }

테스트 스크립트

리포지토리에는 test-connection-management.js 라는 테스트 스크립트가 포함되어 있습니다.이 스크립트를 사용하여 연결 관리 기능을 테스트 할 수 있습니다.

개발자 정보

개발 환경 설정

빌드

라이센스

ISC

기여

버그 리포트, 기능 요청, 풀 요청을 환영합니다.