@ahngbeom/mysql-mcp-server 1.0.0 → 1.0.1
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 +16 -40
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,9 +4,9 @@ Claude Code에서 MySQL 데이터베이스에 접근하기 위한 **읽기 전
|
|
|
4
4
|
|
|
5
5
|
## 특징
|
|
6
6
|
|
|
7
|
-
- **읽기 전용**: SELECT
|
|
8
|
-
- **안전한 연결**: Connection Pool 사용
|
|
9
|
-
-
|
|
7
|
+
- **읽기 전용**: `SELECT`, `SHOW`, `DESCRIBE`, `EXPLAIN` 쿼리만 허용
|
|
8
|
+
- **안전한 연결**: Connection Pool 사용 (최대 5개 연결)
|
|
9
|
+
- **6가지 도구 제공**: 쿼리 실행, 테이블 목록, 스키마 조회, 인덱스 확인, DDL 조회, 실행 계획 분석
|
|
10
10
|
|
|
11
11
|
## 설치
|
|
12
12
|
|
|
@@ -14,18 +14,7 @@ Claude Code에서 MySQL 데이터베이스에 접근하기 위한 **읽기 전
|
|
|
14
14
|
npm install @ahngbeom/mysql-mcp-server
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
```bash
|
|
20
|
-
git clone https://github.com/ahngbeom/mysql-mcp-server.git
|
|
21
|
-
cd mysql-mcp-server
|
|
22
|
-
npm install
|
|
23
|
-
npm run build
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## 사용법
|
|
27
|
-
|
|
28
|
-
### Claude Code 설정
|
|
17
|
+
## Claude Code 설정
|
|
29
18
|
|
|
30
19
|
`~/.claude.json` 또는 프로젝트의 `.mcp.json`에 추가:
|
|
31
20
|
|
|
@@ -47,7 +36,7 @@ npm run build
|
|
|
47
36
|
}
|
|
48
37
|
```
|
|
49
38
|
|
|
50
|
-
|
|
39
|
+
## 환경 변수
|
|
51
40
|
|
|
52
41
|
| 변수 | 설명 | 기본값 |
|
|
53
42
|
|------|------|--------|
|
|
@@ -59,32 +48,19 @@ npm run build
|
|
|
59
48
|
|
|
60
49
|
## 제공 도구
|
|
61
50
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
### `describe_table`
|
|
72
|
-
테이블의 구조(컬럼, 타입, 키)를 확인합니다.
|
|
73
|
-
|
|
74
|
-
### `show_indexes`
|
|
75
|
-
테이블의 인덱스 정보를 조회합니다.
|
|
76
|
-
|
|
77
|
-
### `show_create_table`
|
|
78
|
-
테이블의 CREATE TABLE 문을 확인합니다.
|
|
79
|
-
|
|
80
|
-
### `explain`
|
|
81
|
-
쿼리의 실행 계획을 분석합니다.
|
|
51
|
+
| 도구 | 설명 | 예시 |
|
|
52
|
+
|------|------|------|
|
|
53
|
+
| `query` | 읽기 전용 SQL 쿼리 실행 | `SELECT * FROM users LIMIT 10` |
|
|
54
|
+
| `list_tables` | 데이터베이스의 모든 테이블 조회 | - |
|
|
55
|
+
| `describe_table` | 테이블 구조 (컬럼, 타입, 키) 확인 | `users` |
|
|
56
|
+
| `show_indexes` | 테이블의 인덱스 정보 조회 | `users` |
|
|
57
|
+
| `show_create_table` | CREATE TABLE 문 확인 | `users` |
|
|
58
|
+
| `explain` | 쿼리 실행 계획 분석 | `SELECT * FROM users WHERE id = 1` |
|
|
82
59
|
|
|
83
|
-
## 보안
|
|
60
|
+
## 보안
|
|
84
61
|
|
|
85
|
-
-
|
|
86
|
-
-
|
|
87
|
-
- 프로덕션 환경에서는 읽기 전용 DB 사용자 계정 사용을 권장합니다
|
|
62
|
+
- `INSERT`, `UPDATE`, `DELETE`, `DROP` 등 쓰기 쿼리는 차단됩니다
|
|
63
|
+
- 프로덕션 환경에서는 **읽기 전용 DB 계정** 사용을 권장합니다
|
|
88
64
|
|
|
89
65
|
## 라이선스
|
|
90
66
|
|