@cano721/mysql-mcp-server 0.2.0 → 0.3.0

package/README.md

@@ -22,17 +22,19 @@
 
 ## 보안 기능
 
-- **읽기 전용 접근**: SELECT, SHOW, DESCRIBE 문 항상 허용, EXPLAIN 선택적 허용
+- **읽기 전용 접근**: SELECT, SHOW, DESCRIBE 문 항상 허용
+- **선택적 분석 도구**: EXPLAIN, ANALYZE 선택적 허용
 - **쿼리 검증**: SQL 인젝션 방지 및 데이터 수정 시도 차단
 - **쿼리 타임아웃**: 장시간 실행되는 쿼리로부터 리소스 보호
 - **행 제한**: 과도한 데이터 반환 방지 (최대 1000행)
-- **선택적 기능 제어**: EXPLAIN 쿼리 허용/차단 설정 가능
+- **세밀한 권한 제어**: 각 분석 도구별 개별 활성화/비활성화
 
 **지원되는 SQL 명령어**:
 - `SELECT` - 데이터 조회 및 분석 (항상 허용)
 - `SHOW` - 데이터베이스/테이블/인덱스 정보 조회 (항상 허용)
 - `DESCRIBE` / `DESC` - 테이블 구조 및 컬럼 정보 (항상 허용)
 - `EXPLAIN` - 쿼리 실행 계획 및 성능 분석 (선택적 허용, 기본값: 허용)
+- `ANALYZE` - 테이블 통계 분석 및 업데이트 (선택적 허용, 기본값: 비허용)
 
 ## 요구사항
 
@@ -103,6 +105,7 @@ npx -y @smithery/cli install @cano721/mysql-mcp-server --client claude
 
 **보안 설정:**
 - `MYSQL_ALLOW_EXPLAIN`: EXPLAIN 쿼리 허용 여부 (기본값: true, 비활성화: false)
+- `MYSQL_ALLOW_ANALYZE`: ANALYZE 쿼리 허용 여부 (기본값: false, 활성화: true)
 
 ### 3. MCP 설정에 추가
 
@@ -264,6 +267,18 @@ MySQL 서버에서 접근 가능한 모든 데이터베이스를 나열합니다
 }
 ```
 
+**ANALYZE 사용 예제** (MYSQL_ALLOW_ANALYZE=true 필요):
+```json
+{
+  "server_name": "mysql",
+  "tool_name": "execute_query",
+  "arguments": {
+    "database": "my_database",
+    "query": "ANALYZE TABLE my_table"
+  }
+}
+```
+
 **SHOW 명령어 예제**:
 ```json
 {
@@ -298,7 +313,8 @@ MySQL 연결 풀 동작을 더 세밀하게 제어하려면 추가 매개변수
         "MYSQL_CONNECT_TIMEOUT": "10000",
         "MYSQL_IDLE_TIMEOUT": "60000",
         "MYSQL_MAX_IDLE": "10",
-        "MYSQL_ALLOW_EXPLAIN": "true"
+        "MYSQL_ALLOW_EXPLAIN": "true",
+        "MYSQL_ALLOW_ANALYZE": "false"
       },
       "disabled": false,
       "autoApprove": []
@@ -315,6 +331,7 @@ MySQL 연결 풀 동작을 더 세밀하게 제어하려면 추가 매개변수
 - `MYSQL_IDLE_TIMEOUT`: 연결이 해제되기 전까지 유휴 상태로 있을 수 있는 시간 (밀리초 단위)
 - `MYSQL_MAX_IDLE`: 풀에 유지할 최대 유휴 연결 수 설정
 - `MYSQL_ALLOW_EXPLAIN`: EXPLAIN 쿼리 허용 여부 (기본값: true)
+- `MYSQL_ALLOW_ANALYZE`: ANALYZE 쿼리 허용 여부 (기본값: false)
 
 ## 테스트
 

package/build/connection.js

@@ -104,6 +104,7 @@ export function getConfigFromEnv() {
     const maxIdleStr = process.env.MYSQL_MAX_IDLE;
     // Security options
     const allowExplain = process.env.MYSQL_ALLOW_EXPLAIN !== 'false'; // Default: true
+    const allowAnalyze = process.env.MYSQL_ALLOW_ANALYZE === 'true'; // Default: false
     if (!host)
         throw new Error('MYSQL_HOST environment variable is required');
     if (!user)
@@ -116,7 +117,8 @@ export function getConfigFromEnv() {
     const idleTimeout = idleTimeoutStr ? parseInt(idleTimeoutStr, 10) : undefined;
     const maxIdle = maxIdleStr ? parseInt(maxIdleStr, 10) : undefined;
     console.error('[Setup] Security settings:', {
-        allowExplain
+        allowExplain,
+        allowAnalyze
     });
     return {
         host,

package/build/index.js

@@ -46,13 +46,17 @@ const server = new Server({
  * Handler that lists available tools for MySQL database access
  */
 server.setRequestHandler(ListToolsRequestSchema, async () => {
-    // Check if EXPLAIN is enabled
+    // Check if optional commands are enabled
     const allowExplain = process.env.MYSQL_ALLOW_EXPLAIN !== 'false';
+    const allowAnalyze = process.env.MYSQL_ALLOW_ANALYZE === 'true';
     // Build allowed commands description
     const allowedCommands = ['SELECT', 'SHOW', 'DESCRIBE'];
     if (allowExplain) {
         allowedCommands.push('EXPLAIN');
     }
+    if (allowAnalyze) {
+        allowedCommands.push('ANALYZE');
+    }
     const commandsDescription = `SQL query (only ${allowedCommands.join(', ')} statements are allowed)`;
     return {
         tools: [

package/build/validators.js

@@ -12,6 +12,7 @@ const ALLOWED_COMMANDS = [
 // Optional commands that can be enabled/disabled
 const OPTIONAL_COMMANDS = [
     'EXPLAIN',
+    'ANALYZE',
 ];
 // List of disallowed SQL commands (write operations)
 const DISALLOWED_COMMANDS = [
@@ -45,7 +46,12 @@ function getAllowedCommands() {
     // Check if EXPLAIN is enabled (default: true)
     const allowExplain = process.env.MYSQL_ALLOW_EXPLAIN !== 'false';
     if (allowExplain) {
-        allowedCommands.push(...OPTIONAL_COMMANDS);
+        allowedCommands.push('EXPLAIN');
+    }
+    // Check if ANALYZE is enabled (default: false)
+    const allowAnalyze = process.env.MYSQL_ALLOW_ANALYZE === 'true';
+    if (allowAnalyze) {
+        allowedCommands.push('ANALYZE');
     }
     return allowedCommands;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cano721/mysql-mcp-server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "An MCP server that provides read-only access to MySQL databases.",
   "type": "module",
   "bin": {