@cano721/mysql-mcp-server 0.1.12 → 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.
Files changed (2) hide show
  1. package/README.md +22 -1
  2. 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. 서버 로그에서 오류 메시지 확인
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cano721/mysql-mcp-server",
3
- "version": "0.1.12",
3
+ "version": "0.1.13",
4
4
  "description": "An MCP server that provides read-only access to MySQL databases.",
5
5
  "type": "module",
6
6
  "bin": {