@cano721/mysql-mcp-server 0.1.10 → 0.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +70 -3
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -429,9 +429,6 @@ node --version
429
429
 
430
430
  # npm 버전 확인
431
431
  npm --version
432
-
433
- # Node.js 업데이트가 필요한 경우:
434
- # https://nodejs.org/ 에서 최신 LTS 버전 다운로드
435
432
  ```
436
433
 
437
434
  **Node.js 18 미만이면 다음 오류가 발생할 수 있습니다:**
@@ -439,6 +436,76 @@ npm --version
439
436
  - 최신 JavaScript 기능 미지원
440
437
  - 의존성 패키지 호환성 문제
441
438
 
439
+ **Node.js 업데이트 방법:**
440
+
441
+ ##### 방법 1: 공식 웹사이트에서 다운로드 (권장)
442
+ 1. https://nodejs.org/ 방문
443
+ 2. **LTS 버전** (Long Term Support) 다운로드
444
+ 3. 설치 프로그램 실행
445
+ 4. 터미널 재시작 후 버전 확인: `node --version`
446
+
447
+ ##### 방법 2: nvm 사용 (개발자 권장)
448
+ ```bash
449
+ # nvm 설치 (macOS/Linux)
450
+ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
451
+
452
+ # 터미널 재시작 후
453
+ nvm install --lts # 최신 LTS 버전 설치
454
+ nvm use --lts # LTS 버전 사용
455
+ nvm alias default lts/* # 기본값으로 설정
456
+ ```
457
+
458
+ ##### 방법 3: Homebrew 사용 (macOS)
459
+ ```bash
460
+ # Homebrew로 Node.js 업데이트
461
+ brew install node
462
+
463
+ # 또는 기존 설치가 있다면
464
+ brew upgrade node
465
+ ```
466
+
467
+ ##### 방법 4: 패키지 매니저 사용 (Linux)
468
+ ```bash
469
+ # Ubuntu/Debian
470
+ curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
471
+ sudo apt-get install -y nodejs
472
+
473
+ # CentOS/RHEL/Fedora
474
+ curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
475
+ sudo yum install -y nodejs
476
+ ```
477
+
478
+ ##### 방법 5: Windows
479
+ 1. https://nodejs.org/ 에서 Windows Installer 다운로드
480
+ 2. 또는 Chocolatey 사용: `choco install nodejs`
481
+ 3. 또는 Scoop 사용: `scoop install nodejs`
482
+
483
+ **Node.js 업데이트 후 설정:**
484
+ ```bash
485
+ # 1. 터미널/명령 프롬프트 재시작 (중요!)
486
+
487
+ # 2. 버전 확인
488
+ node --version # v18.0.0 이상인지 확인
489
+ npm --version # 8.0.0 이상인지 확인
490
+
491
+ # 3. npm 캐시 클리어 (권장)
492
+ npm cache clean --force
493
+
494
+ # 4. MCP 서버 테스트
495
+ npx @cano721/mysql-mcp-server@latest
496
+
497
+ # 5. 환경 변수 설정 후 테스트
498
+ export MYSQL_HOST=localhost
499
+ export MYSQL_PORT=4307
500
+ export MYSQL_USER=developer
501
+ echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx @cano721/mysql-mcp-server
502
+ ```
503
+
504
+ **주의사항:**
505
+ - Node.js 업데이트 후 **반드시 터미널을 재시작**하세요
506
+ - IDE(IntelliJ, VSCode 등)도 재시작해야 새 Node.js 버전을 인식합니다
507
+ - 기존에 전역 설치한 패키지들은 재설치가 필요할 수 있습니다
508
+
442
509
  #### 1. npx 캐시 문제
443
510
  ```bash
444
511
  # 최신 버전 강제 사용
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cano721/mysql-mcp-server",
3
- "version": "0.1.10",
3
+ "version": "0.1.12",
4
4
  "description": "An MCP server that provides read-only access to MySQL databases.",
5
5
  "type": "module",
6
6
  "bin": {