1. 

 

MySQL MCP 서버는 npx로 실행합니다. npx는 Node.js와 함께 설치되므로, MCP 연결 전에 Node.js를 준비합니다. 먼저 기존 설치 여부를 확인합니다.

  • npx 약자: Node Package eXecute
  • 한 줄 정의: Node.js 패키지(프로그램)를 컴퓨터에 설치하지 않고 즉시 실행해 주는 도구
  • Node (노드): 자바스크립트라는 프로그래밍 언어를 컴퓨터(서버)에서 실행할 수 있게 해주는 환경입니다.

 

node --version

 

 

 

2. 

 

위 결과처럼 버전이 없거나 오래됐다면 nvm 방식으로 Node.js 24 LTS를 설치합니다.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash

 

구분 curl ... nvm 설치 방식 (NVM 사용) sudo apt install nodejs 방식
버전 선택 내가 원하는 버전을 마음대로 골라 설치 가능 (v18, v20, v22 등) 우분투(OS)가 제공하는 옛날 버전만 설치됨

 

 

 

3. 

 

NVM을 처음 설치하면 컴퓨터에는 파일이 깔렸지만, 현재 열려 있는 터미널 창은 그 사실을 아직 모르는 상태입니다.

설치가 끝나면 현재 터미널에 nvm 설정을 적용합니다.

 

  • source : 뒤에 나오는 스크립트 파일을 실행해서, 그 안의 설정들을 현재 터미널 창에 즉시 적용하라는 리눅스/맥 명령어입니다.
  • "$HOME" : 내 컴퓨터의 사용자 홈 디렉토리(예: /home/ubuntu 또는 /Users/username)를 뜻하는 지름길 경로입니다.
  • /.nvm/nvm.sh : NVM 설치 시 생성된 실제 실행 파일(셸 스크립트)입니다.

 

source "$HOME/.nvm/nvm.sh"

 

 

 

4. 

 

Node.js 24 LTS를 설치하고 기본 버전으로 지정합니다.

nvm install 24
nvm alias default 24

 

 

 

5. 

 

설치 결과를 확인합니다.

node가 v24로 시작하고 npm·npx도 버전 번호가 나오면 정상입니다.

node --version
npm --version
npx --version

 

💡 Windows·macOS 참고: 기본 환경은 Ubuntu입니다. 다른 운영체제라면 Node.js 공식 다운로드 페이지에서 LTS 설치 방법을 선택하고, 이후 화면·명령은 Ubuntu 기준으로 따라갑니다.

▶ 지금 해보세요

  1. node --version으로 기존 설치 상태를 확인합니다.
  2. 없거나 24 LTS가 아니면 nvm으로 Node.js 24를 설치합니다.
  3. node, npm, npx의 버전을 모두 확인합니다.

✔ 확인 기준: node --version이 v24로 시작하고 npm, npx도 버전 번호를 출력합니다.

 

티스토리툴바