@cano721/mysql-mcp-server 0.1.12 → 0.1.14
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 +60 -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 문만 허용
|
|
@@ -16,11 +27,19 @@
|
|
|
16
27
|
- **쿼리 타임아웃**: 장시간 실행되는 쿼리로부터 리소스 보호
|
|
17
28
|
- **행 제한**: 과도한 데이터 반환 방지 (최대 1000행)
|
|
18
29
|
|
|
30
|
+
**지원되는 SQL 명령어**:
|
|
31
|
+
- `SELECT` - 데이터 조회 및 분석
|
|
32
|
+
- `SHOW` - 데이터베이스/테이블/인덱스 정보 조회
|
|
33
|
+
- `DESCRIBE` / `DESC` - 테이블 구조 및 컬럼 정보
|
|
34
|
+
- `EXPLAIN` - 쿼리 실행 계획 및 성능 분석
|
|
35
|
+
|
|
19
36
|
## 요구사항
|
|
20
37
|
|
|
21
|
-
- **Node.js**: 18.0.0 이상
|
|
38
|
+
- **Node.js**: 18.0.0 이상 → [Node.js 업데이트 방법](#0-nodejs-버전-확인-가장-중요)
|
|
22
39
|
- **npm**: 8.0.0 이상 (Node.js와 함께 설치됨)
|
|
23
40
|
|
|
41
|
+
💡 **Node.js 버전이 낮다면?** [여기를 클릭해서 업데이트 방법을 확인하세요](#0-nodejs-버전-확인-가장-중요)
|
|
42
|
+
|
|
24
43
|
## 설치
|
|
25
44
|
|
|
26
45
|
### 방법 1: npx 사용 (대부분의 MCP 클라이언트에서 권장)
|
|
@@ -208,6 +227,12 @@ MySQL 서버에서 접근 가능한 모든 데이터베이스를 나열합니다
|
|
|
208
227
|
- `query` (필수): SQL 쿼리 (SELECT, SHOW, DESCRIBE, EXPLAIN 문만 허용)
|
|
209
228
|
- `database` (선택사항): 데이터베이스명 (지정하지 않으면 기본값 사용)
|
|
210
229
|
|
|
230
|
+
**지원되는 쿼리 유형**:
|
|
231
|
+
- `SELECT` - 데이터 조회
|
|
232
|
+
- `SHOW` - 데이터베이스/테이블 정보 표시
|
|
233
|
+
- `DESCRIBE` / `DESC` - 테이블 구조 설명
|
|
234
|
+
- `EXPLAIN` - 쿼리 실행 계획 분석
|
|
235
|
+
|
|
211
236
|
**예제**:
|
|
212
237
|
```json
|
|
213
238
|
{
|
|
@@ -220,6 +245,30 @@ MySQL 서버에서 접근 가능한 모든 데이터베이스를 나열합니다
|
|
|
220
245
|
}
|
|
221
246
|
```
|
|
222
247
|
|
|
248
|
+
**EXPLAIN 사용 예제**:
|
|
249
|
+
```json
|
|
250
|
+
{
|
|
251
|
+
"server_name": "mysql",
|
|
252
|
+
"tool_name": "execute_query",
|
|
253
|
+
"arguments": {
|
|
254
|
+
"database": "my_database",
|
|
255
|
+
"query": "EXPLAIN SELECT * FROM my_table WHERE id = 1"
|
|
256
|
+
}
|
|
257
|
+
}
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
**SHOW 명령어 예제**:
|
|
261
|
+
```json
|
|
262
|
+
{
|
|
263
|
+
"server_name": "mysql",
|
|
264
|
+
"tool_name": "execute_query",
|
|
265
|
+
"arguments": {
|
|
266
|
+
"database": "my_database",
|
|
267
|
+
"query": "SHOW CREATE TABLE my_table"
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
```
|
|
271
|
+
|
|
223
272
|
## 고급 연결 풀 설정
|
|
224
273
|
|
|
225
274
|
MySQL 연결 풀 동작을 더 세밀하게 제어하려면 추가 매개변수를 설정할 수 있습니다:
|
|
@@ -404,9 +453,19 @@ Cursor IDE에서 MCP 서버를 사용하려면 `.cursor/mcp.json` 파일을 생
|
|
|
404
453
|
- ✅ **테이블 목록 조회**: MySQL 시스템 데이터베이스의 40개 테이블 조회
|
|
405
454
|
- ✅ **테이블 스키마 조회**: user 테이블의 46개 컬럼 정보 조회
|
|
406
455
|
- ✅ **SQL 쿼리 실행**: 사용자 정보 조회 쿼리 성공적으로 실행
|
|
456
|
+
- ✅ **EXPLAIN 쿼리**: 쿼리 실행 계획 분석 지원
|
|
457
|
+
- ✅ **SHOW 명령어**: 데이터베이스 메타데이터 조회 지원
|
|
407
458
|
|
|
408
459
|
## 문제 해결
|
|
409
460
|
|
|
461
|
+
**빠른 해결책:**
|
|
462
|
+
- 🔧 [Node.js 버전이 낮은 경우](#0-nodejs-버전-확인-가장-중요)
|
|
463
|
+
- 💾 [npx 캐시 문제](#1-npx-캐시-문제)
|
|
464
|
+
- 🔌 [연결이 안 되는 경우](#2-환경-변수-전달-문제)
|
|
465
|
+
- 📦 [전역 설치로 해결](#4-대안-전역-설치-사용)
|
|
466
|
+
|
|
467
|
+
---
|
|
468
|
+
|
|
410
469
|
문제가 발생하면:
|
|
411
470
|
|
|
412
471
|
1. 서버 로그에서 오류 메시지 확인
|