@cano721/mysql-mcp-server 0.1.11 → 0.1.13
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 +48 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -9,6 +9,17 @@
|
|
|
9
9
|
- 테이블 스키마 설명
|
|
10
10
|
- 읽기 전용 SQL 쿼리 실행
|
|
11
11
|
|
|
12
|
+
## 📋 목차
|
|
13
|
+
|
|
14
|
+
- [요구사항](#요구사항)
|
|
15
|
+
- [설치](#설치)
|
|
16
|
+
- [사용 가능한 도구](#사용-가능한-도구)
|
|
17
|
+
- [실제 사용 예제](#실제-사용-예제)
|
|
18
|
+
- [문제 해결](#문제-해결)
|
|
19
|
+
- [Node.js 버전 확인 및 업데이트](#0-nodejs-버전-확인-가장-중요)
|
|
20
|
+
- [npx 관련 문제](#npx-관련-문제)
|
|
21
|
+
- [라이선스](#라이선스)
|
|
22
|
+
|
|
12
23
|
## 보안 기능
|
|
13
24
|
|
|
14
25
|
- **읽기 전용 접근**: SELECT, SHOW, DESCRIBE, EXPLAIN 문만 허용
|
|
@@ -18,9 +29,11 @@
|
|
|
18
29
|
|
|
19
30
|
## 요구사항
|
|
20
31
|
|
|
21
|
-
- **Node.js**: 18.0.0 이상
|
|
32
|
+
- **Node.js**: 18.0.0 이상 → [Node.js 업데이트 방법](#0-nodejs-버전-확인-가장-중요)
|
|
22
33
|
- **npm**: 8.0.0 이상 (Node.js와 함께 설치됨)
|
|
23
34
|
|
|
35
|
+
💡 **Node.js 버전이 낮다면?** [여기를 클릭해서 업데이트 방법을 확인하세요](#0-nodejs-버전-확인-가장-중요)
|
|
36
|
+
|
|
24
37
|
## 설치
|
|
25
38
|
|
|
26
39
|
### 방법 1: npx 사용 (대부분의 MCP 클라이언트에서 권장)
|
|
@@ -407,6 +420,14 @@ Cursor IDE에서 MCP 서버를 사용하려면 `.cursor/mcp.json` 파일을 생
|
|
|
407
420
|
|
|
408
421
|
## 문제 해결
|
|
409
422
|
|
|
423
|
+
**빠른 해결책:**
|
|
424
|
+
- 🔧 [Node.js 버전이 낮은 경우](#0-nodejs-버전-확인-가장-중요)
|
|
425
|
+
- 💾 [npx 캐시 문제](#1-npx-캐시-문제)
|
|
426
|
+
- 🔌 [연결이 안 되는 경우](#2-환경-변수-전달-문제)
|
|
427
|
+
- 📦 [전역 설치로 해결](#4-대안-전역-설치-사용)
|
|
428
|
+
|
|
429
|
+
---
|
|
430
|
+
|
|
410
431
|
문제가 발생하면:
|
|
411
432
|
|
|
412
433
|
1. 서버 로그에서 오류 메시지 확인
|
|
@@ -480,6 +501,32 @@ sudo yum install -y nodejs
|
|
|
480
501
|
2. 또는 Chocolatey 사용: `choco install nodejs`
|
|
481
502
|
3. 또는 Scoop 사용: `scoop install nodejs`
|
|
482
503
|
|
|
504
|
+
**Node.js 업데이트 후 설정:**
|
|
505
|
+
```bash
|
|
506
|
+
# 1. 터미널/명령 프롬프트 재시작 (중요!)
|
|
507
|
+
|
|
508
|
+
# 2. 버전 확인
|
|
509
|
+
node --version # v18.0.0 이상인지 확인
|
|
510
|
+
npm --version # 8.0.0 이상인지 확인
|
|
511
|
+
|
|
512
|
+
# 3. npm 캐시 클리어 (권장)
|
|
513
|
+
npm cache clean --force
|
|
514
|
+
|
|
515
|
+
# 4. MCP 서버 테스트
|
|
516
|
+
npx @cano721/mysql-mcp-server@latest
|
|
517
|
+
|
|
518
|
+
# 5. 환경 변수 설정 후 테스트
|
|
519
|
+
export MYSQL_HOST=localhost
|
|
520
|
+
export MYSQL_PORT=4307
|
|
521
|
+
export MYSQL_USER=developer
|
|
522
|
+
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx @cano721/mysql-mcp-server
|
|
523
|
+
```
|
|
524
|
+
|
|
525
|
+
**주의사항:**
|
|
526
|
+
- Node.js 업데이트 후 **반드시 터미널을 재시작**하세요
|
|
527
|
+
- IDE(IntelliJ, VSCode 등)도 재시작해야 새 Node.js 버전을 인식합니다
|
|
528
|
+
- 기존에 전역 설치한 패키지들은 재설치가 필요할 수 있습니다
|
|
529
|
+
|
|
483
530
|
#### 1. npx 캐시 문제
|
|
484
531
|
```bash
|
|
485
532
|
# 최신 버전 강제 사용
|