@cano721/mysql-mcp-server 0.3.0 → 0.3.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 +7 -7
- package/build/connection.js +1 -1
- package/build/index.js +1 -1
- package/build/validators.js +2 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
## 보안 기능
|
|
24
24
|
|
|
25
25
|
- **읽기 전용 접근**: SELECT, SHOW, DESCRIBE 문 항상 허용
|
|
26
|
-
-
|
|
26
|
+
- **분석 도구**: EXPLAIN, ANALYZE 기본 허용 (읽기 전용 분석)
|
|
27
27
|
- **쿼리 검증**: SQL 인젝션 방지 및 데이터 수정 시도 차단
|
|
28
28
|
- **쿼리 타임아웃**: 장시간 실행되는 쿼리로부터 리소스 보호
|
|
29
29
|
- **행 제한**: 과도한 데이터 반환 방지 (최대 1000행)
|
|
@@ -33,8 +33,8 @@
|
|
|
33
33
|
- `SELECT` - 데이터 조회 및 분석 (항상 허용)
|
|
34
34
|
- `SHOW` - 데이터베이스/테이블/인덱스 정보 조회 (항상 허용)
|
|
35
35
|
- `DESCRIBE` / `DESC` - 테이블 구조 및 컬럼 정보 (항상 허용)
|
|
36
|
-
- `EXPLAIN` - 쿼리 실행 계획 및 성능 분석 (
|
|
37
|
-
- `ANALYZE` - 테이블 통계 분석
|
|
36
|
+
- `EXPLAIN` - 쿼리 실행 계획 및 성능 분석 (기본 허용, 읽기 전용)
|
|
37
|
+
- `ANALYZE` - 테이블 통계 분석 (기본 허용, 읽기 전용)
|
|
38
38
|
|
|
39
39
|
## 요구사항
|
|
40
40
|
|
|
@@ -105,7 +105,7 @@ npx -y @smithery/cli install @cano721/mysql-mcp-server --client claude
|
|
|
105
105
|
|
|
106
106
|
**보안 설정:**
|
|
107
107
|
- `MYSQL_ALLOW_EXPLAIN`: EXPLAIN 쿼리 허용 여부 (기본값: true, 비활성화: false)
|
|
108
|
-
- `MYSQL_ALLOW_ANALYZE`: ANALYZE 쿼리 허용 여부 (기본값:
|
|
108
|
+
- `MYSQL_ALLOW_ANALYZE`: ANALYZE 쿼리 허용 여부 (기본값: true, 비활성화: false)
|
|
109
109
|
|
|
110
110
|
### 3. MCP 설정에 추가
|
|
111
111
|
|
|
@@ -267,7 +267,7 @@ MySQL 서버에서 접근 가능한 모든 데이터베이스를 나열합니다
|
|
|
267
267
|
}
|
|
268
268
|
```
|
|
269
269
|
|
|
270
|
-
**ANALYZE 사용
|
|
270
|
+
**ANALYZE 사용 예제**:
|
|
271
271
|
```json
|
|
272
272
|
{
|
|
273
273
|
"server_name": "mysql",
|
|
@@ -314,7 +314,7 @@ MySQL 연결 풀 동작을 더 세밀하게 제어하려면 추가 매개변수
|
|
|
314
314
|
"MYSQL_IDLE_TIMEOUT": "60000",
|
|
315
315
|
"MYSQL_MAX_IDLE": "10",
|
|
316
316
|
"MYSQL_ALLOW_EXPLAIN": "true",
|
|
317
|
-
"MYSQL_ALLOW_ANALYZE": "
|
|
317
|
+
"MYSQL_ALLOW_ANALYZE": "true"
|
|
318
318
|
},
|
|
319
319
|
"disabled": false,
|
|
320
320
|
"autoApprove": []
|
|
@@ -331,7 +331,7 @@ MySQL 연결 풀 동작을 더 세밀하게 제어하려면 추가 매개변수
|
|
|
331
331
|
- `MYSQL_IDLE_TIMEOUT`: 연결이 해제되기 전까지 유휴 상태로 있을 수 있는 시간 (밀리초 단위)
|
|
332
332
|
- `MYSQL_MAX_IDLE`: 풀에 유지할 최대 유휴 연결 수 설정
|
|
333
333
|
- `MYSQL_ALLOW_EXPLAIN`: EXPLAIN 쿼리 허용 여부 (기본값: true)
|
|
334
|
-
- `MYSQL_ALLOW_ANALYZE`: ANALYZE 쿼리 허용 여부 (기본값:
|
|
334
|
+
- `MYSQL_ALLOW_ANALYZE`: ANALYZE 쿼리 허용 여부 (기본값: true)
|
|
335
335
|
|
|
336
336
|
## 테스트
|
|
337
337
|
|
package/build/connection.js
CHANGED
|
@@ -104,7 +104,7 @@ export function getConfigFromEnv() {
|
|
|
104
104
|
const maxIdleStr = process.env.MYSQL_MAX_IDLE;
|
|
105
105
|
// Security options
|
|
106
106
|
const allowExplain = process.env.MYSQL_ALLOW_EXPLAIN !== 'false'; // Default: true
|
|
107
|
-
const allowAnalyze = process.env.MYSQL_ALLOW_ANALYZE
|
|
107
|
+
const allowAnalyze = process.env.MYSQL_ALLOW_ANALYZE !== 'false'; // Default: true
|
|
108
108
|
if (!host)
|
|
109
109
|
throw new Error('MYSQL_HOST environment variable is required');
|
|
110
110
|
if (!user)
|
package/build/index.js
CHANGED
|
@@ -48,7 +48,7 @@ const server = new Server({
|
|
|
48
48
|
server.setRequestHandler(ListToolsRequestSchema, async () => {
|
|
49
49
|
// Check if optional commands are enabled
|
|
50
50
|
const allowExplain = process.env.MYSQL_ALLOW_EXPLAIN !== 'false';
|
|
51
|
-
const allowAnalyze = process.env.MYSQL_ALLOW_ANALYZE
|
|
51
|
+
const allowAnalyze = process.env.MYSQL_ALLOW_ANALYZE !== 'false';
|
|
52
52
|
// Build allowed commands description
|
|
53
53
|
const allowedCommands = ['SELECT', 'SHOW', 'DESCRIBE'];
|
|
54
54
|
if (allowExplain) {
|
package/build/validators.js
CHANGED
|
@@ -48,8 +48,8 @@ function getAllowedCommands() {
|
|
|
48
48
|
if (allowExplain) {
|
|
49
49
|
allowedCommands.push('EXPLAIN');
|
|
50
50
|
}
|
|
51
|
-
// Check if ANALYZE is enabled (default:
|
|
52
|
-
const allowAnalyze = process.env.MYSQL_ALLOW_ANALYZE
|
|
51
|
+
// Check if ANALYZE is enabled (default: true)
|
|
52
|
+
const allowAnalyze = process.env.MYSQL_ALLOW_ANALYZE !== 'false';
|
|
53
53
|
if (allowAnalyze) {
|
|
54
54
|
allowedCommands.push('ANALYZE');
|
|
55
55
|
}
|