@cano721/mysql-mcp-server 0.1.13 → 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.
Files changed (2) hide show
  1. package/README.md +38 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -27,6 +27,12 @@
27
27
  - **쿼리 타임아웃**: 장시간 실행되는 쿼리로부터 리소스 보호
28
28
  - **행 제한**: 과도한 데이터 반환 방지 (최대 1000행)
29
29
 
30
+ **지원되는 SQL 명령어**:
31
+ - `SELECT` - 데이터 조회 및 분석
32
+ - `SHOW` - 데이터베이스/테이블/인덱스 정보 조회
33
+ - `DESCRIBE` / `DESC` - 테이블 구조 및 컬럼 정보
34
+ - `EXPLAIN` - 쿼리 실행 계획 및 성능 분석
35
+
30
36
  ## 요구사항
31
37
 
32
38
  - **Node.js**: 18.0.0 이상 → [Node.js 업데이트 방법](#0-nodejs-버전-확인-가장-중요)
@@ -221,6 +227,12 @@ MySQL 서버에서 접근 가능한 모든 데이터베이스를 나열합니다
221
227
  - `query` (필수): SQL 쿼리 (SELECT, SHOW, DESCRIBE, EXPLAIN 문만 허용)
222
228
  - `database` (선택사항): 데이터베이스명 (지정하지 않으면 기본값 사용)
223
229
 
230
+ **지원되는 쿼리 유형**:
231
+ - `SELECT` - 데이터 조회
232
+ - `SHOW` - 데이터베이스/테이블 정보 표시
233
+ - `DESCRIBE` / `DESC` - 테이블 구조 설명
234
+ - `EXPLAIN` - 쿼리 실행 계획 분석
235
+
224
236
  **예제**:
225
237
  ```json
226
238
  {
@@ -233,6 +245,30 @@ MySQL 서버에서 접근 가능한 모든 데이터베이스를 나열합니다
233
245
  }
234
246
  ```
235
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
+
236
272
  ## 고급 연결 풀 설정
237
273
 
238
274
  MySQL 연결 풀 동작을 더 세밀하게 제어하려면 추가 매개변수를 설정할 수 있습니다:
@@ -417,6 +453,8 @@ Cursor IDE에서 MCP 서버를 사용하려면 `.cursor/mcp.json` 파일을 생
417
453
  - ✅ **테이블 목록 조회**: MySQL 시스템 데이터베이스의 40개 테이블 조회
418
454
  - ✅ **테이블 스키마 조회**: user 테이블의 46개 컬럼 정보 조회
419
455
  - ✅ **SQL 쿼리 실행**: 사용자 정보 조회 쿼리 성공적으로 실행
456
+ - ✅ **EXPLAIN 쿼리**: 쿼리 실행 계획 분석 지원
457
+ - ✅ **SHOW 명령어**: 데이터베이스 메타데이터 조회 지원
420
458
 
421
459
  ## 문제 해결
422
460
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cano721/mysql-mcp-server",
3
- "version": "0.1.13",
3
+ "version": "0.1.14",
4
4
  "description": "An MCP server that provides read-only access to MySQL databases.",
5
5
  "type": "module",
6
6
  "bin": {