MySQL 네비게이터 MCP

MCP(Model Control Protocol)를 사용하여 데이터베이스를 쉽게 쿼리하고 관리할 수 있는 강력한 MySQL/MariaDB 데이터베이스 탐색 도구입니다.

특징

MySQL/MariaDB 데이터베이스에 연결
다양한 데이터베이스 간에 동적으로 전환
유형 안전성을 갖춘 SQL 쿼리 실행
데이터베이스 스키마 정보 검색
쿼리 매개변수에 대한 Pydantic 모델 검증
보안 자격 증명 관리
종합 로깅 시스템
연결 풀링 및 재시도 메커니즘
보안 연결을 위한 SSL/TLS 지원

로그 파일 위치(크로스 플랫폼)

기본적으로 모든 로그는 다음 위치에 기록됩니다.

Windows: C:\Users\<YourUsername>\.mcp\mcp-db.log
macOS/Linux: /home/<yourusername>/.mcp/mcp-db.log mcp/mcp-db.log 또는 /Users/<yourusername>/.mcp/mcp-db.log /mcp-db.log

홈 디렉터리에 .mcp 폴더가 없으면 애플리케이션이 자동으로 폴더를 생성합니다. 문제가 발생하면 폴더를 수동으로 생성할 수 있습니다.

윈도우:

지엑스피1

macOS/Linux:

mkdir -p ~/.mcp

설치

PyPI에서 (대부분의 사용자에게 권장):

pip install mcp-db-navigator

소스에서(개발용):

git clone <your-repo-url>
cd mcp-db
pip install -e .

데이터베이스 자격 증명으로 .env 파일을 만듭니다.

DB_HOST=your_host
DB_PORT=your_port
DB_NAME=your_database_name
DB_USER=your_username
DB_PASSWORD=your_password
DB_SSL_CA=/path/to/ssl/ca.pem  # Optional: for SSL/TLS connections
DB_MAX_RETRIES=3  # Optional: number of connection retries
DB_RETRY_DELAY=1.0  # Optional: delay between retries in seconds

사용 예

1. 명령줄

터미널에서 MCP 서버를 직접 실행하세요.

mcp-db --config /path/to/your/project/.env

2. 커서

Cursor 에서 이 MCP 서버를 사용하려면:

커서 설정을 열고 새로운 MCP 서버를 추가합니다.
다음 구성을 사용하세요(예):

{
  "mcpServers": {
    "mysql-navigator": {
      "command": "mcp-db",
      "args": [
        "--config",
        "/absolute/path/to/your/.env"
      ]
    }
  }
}

.env 파일의 경로가 절대 경로인지 확인하세요.

3. 클로드 데스크탑

Claude Desktop이 MCP 서버를 지원하는 경우:

새로운 MCP 서버를 추가하고 위와 같이 --config 인수를 사용하여 mcp-db 명령을 가리키도록 합니다.
사용자 정의 MCP 서버를 추가하는 방법에 대한 자세한 내용은 Claude Desktop 설명서를 참조하세요.

쿼리 매개변수

쿼리 사전은 다음 매개변수를 지원합니다.

table_name (필수): 쿼리할 테이블의 이름
select_fields (선택 사항): 선택할 필드 목록(기본값은 ["*"])
where_conditions (선택 사항): WHERE 절에 대한 필드-값 쌍 사전
order_by (선택 사항): 정렬 기준 필드 목록
order_direction (선택 사항): 정렬 방향 "ASC" 또는 "DESC"(기본값: "ASC")
limit (선택 사항): 반환할 레코드 수
offset (선택 사항): 건너뛸 레코드 수
group_by (선택 사항): 그룹화할 필드 목록
(선택 having ): HAVING 절에 대한 필드-값 쌍 사전
join_table (선택 사항): 조인할 테이블의 이름
join_type (선택 사항): JOIN 작업 유형(기본값: "INNER")
join_conditions (선택 사항): 조인 조건 사전

보안 기능

데이터베이스 자격 증명은 구성 파일을 통해 관리됩니다.
비밀번호는 Pydantic 모델에서 SecretStr로 저장됩니다.
모든 쿼리 매개변수에 대한 입력 검증
매개변수화된 쿼리를 통한 SQL 주입 방지
암호화된 연결을 위한 SSL/TLS 지원
연결 문자열 정리
쿼리에 대한 속도 제한
쿼리 매개변수 정리

제작 특징

오류 처리

데이터베이스 작업을 위한 포괄적인 오류 처리
연결 시간 초과 처리
실패한 연결에 대한 자동 재시도 메커니즘
모든 매개변수에 대한 입력 검증

성능

최적의 리소스 사용을 위한 연결 풀링
쿼리 실행 시간 로깅
연결 풀 통계
성능 지표 수집

모니터링

다양한 로그 수준을 갖춘 구조화된 로깅
쿼리 실행 추적
연결 상태 모니터링
오류율 추적

기여하다

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

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

MySQL Navigator MCP

Integrations