@cano721/mysql-mcp-server 0.1.9 → 0.1.11
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.
- package/README.md +63 -0
- package/package.json +4 -1
package/README.md
CHANGED
|
@@ -16,6 +16,11 @@
|
|
|
16
16
|
- **쿼리 타임아웃**: 장시간 실행되는 쿼리로부터 리소스 보호
|
|
17
17
|
- **행 제한**: 과도한 데이터 반환 방지 (최대 1000행)
|
|
18
18
|
|
|
19
|
+
## 요구사항
|
|
20
|
+
|
|
21
|
+
- **Node.js**: 18.0.0 이상
|
|
22
|
+
- **npm**: 8.0.0 이상 (Node.js와 함께 설치됨)
|
|
23
|
+
|
|
19
24
|
## 설치
|
|
20
25
|
|
|
21
26
|
### 방법 1: npx 사용 (대부분의 MCP 클라이언트에서 권장)
|
|
@@ -417,6 +422,64 @@ Cursor IDE에서 MCP 서버를 사용하려면 `.cursor/mcp.json` 파일을 생
|
|
|
417
422
|
|
|
418
423
|
### npx 관련 문제
|
|
419
424
|
|
|
425
|
+
#### 0. Node.js 버전 확인 (가장 중요!)
|
|
426
|
+
```bash
|
|
427
|
+
# Node.js 버전 확인 (18.0.0 이상 필요)
|
|
428
|
+
node --version
|
|
429
|
+
|
|
430
|
+
# npm 버전 확인
|
|
431
|
+
npm --version
|
|
432
|
+
```
|
|
433
|
+
|
|
434
|
+
**Node.js 18 미만이면 다음 오류가 발생할 수 있습니다:**
|
|
435
|
+
- ES modules 지원 문제
|
|
436
|
+
- 최신 JavaScript 기능 미지원
|
|
437
|
+
- 의존성 패키지 호환성 문제
|
|
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
|
+
|
|
420
483
|
#### 1. npx 캐시 문제
|
|
421
484
|
```bash
|
|
422
485
|
# 최신 버전 강제 사용
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cano721/mysql-mcp-server",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.11",
|
|
4
4
|
"description": "An MCP server that provides read-only access to MySQL databases.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -32,6 +32,9 @@
|
|
|
32
32
|
},
|
|
33
33
|
"author": "cano721",
|
|
34
34
|
"license": "MIT",
|
|
35
|
+
"engines": {
|
|
36
|
+
"node": ">=18.0.0"
|
|
37
|
+
},
|
|
35
38
|
"publishConfig": {
|
|
36
39
|
"access": "public"
|
|
37
40
|
},
|