NodeJS 기반 MySQL용 MCP 서버

MySQL 데이터베이스에 대한 읽기 전용 액세스를 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 통해 LLM은 데이터베이스 스키마를 검사하고 읽기 전용 쿼리를 실행할 수 있습니다.

구성 요소

도구

• mysql_쿼리

  • 연결된 데이터베이스에 대해 읽기 전용 SQL 쿼리를 실행합니다.

  • 입력: sql (문자열): 실행할 SQL 쿼리

  • 모든 쿼리는 READ ONLY 트랜잭션 내에서 실행됩니다.

자원

서버는 데이터베이스의 각 테이블에 대한 스키마 정보를 제공합니다.

• 테이블 스키마

  • 각 테이블에 대한 JSON 스키마 정보

  • 열 이름과 데이터 유형이 포함됩니다.

  • 데이터베이스 메타데이터에서 자동으로 검색됨

Related MCP server: MCP Server for MySQL

Claude Desktop과 함께 사용

Claude Desktop 앱과 함께 이 서버를 사용하려면 claude_desktop_config.json 의 "mcpServers" 섹션에 다음 구성을 추가하세요.

지엑스피1

/db_name 데이터베이스 이름으로 바꾸거나 비워두면 모든 데이터베이스를 검색합니다.

문제 해결

"MCP 서버 mcp-server-mysql에 연결할 수 없습니다" 오류가 발생하는 경우 아래 구성과 같이 모든 필수 바이너리의 경로를 명시적으로 설정해야 할 수 있습니다.

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "/path/to/npx/binary/npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql",
      ],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "db_name"
        "PATH": "/path/to/node/bin:/usr/bin:/bin" <-- Add this
      }

    }
  }
}

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.