@cano721/mysql-mcp-server 0.1.9 → 0.1.10

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 +22 -0
  2. 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,23 @@ 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
+ # Node.js 업데이트가 필요한 경우:
434
+ # https://nodejs.org/ 에서 최신 LTS 버전 다운로드
435
+ ```
436
+
437
+ **Node.js 18 미만이면 다음 오류가 발생할 수 있습니다:**
438
+ - ES modules 지원 문제
439
+ - 최신 JavaScript 기능 미지원
440
+ - 의존성 패키지 호환성 문제
441
+
420
442
  #### 1. npx 캐시 문제
421
443
  ```bash
422
444
  # 최신 버전 강제 사용
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cano721/mysql-mcp-server",
3
- "version": "0.1.9",
3
+ "version": "0.1.10",
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
  },