@cano721/mysql-mcp-server 0.1.14 → 0.3.0

package/README.md

@@ -22,16 +22,19 @@
 
 ## 보안 기능
 
-- **읽기 전용 접근**: SELECT, SHOW, DESCRIBE, EXPLAIN 문만 허용
+- **읽기 전용 접근**: SELECT, SHOW, DESCRIBE 문 항상 허용
+- **선택적 분석 도구**: EXPLAIN, ANALYZE 선택적 허용
 - **쿼리 검증**: SQL 인젝션 방지 및 데이터 수정 시도 차단
 - **쿼리 타임아웃**: 장시간 실행되는 쿼리로부터 리소스 보호
 - **행 제한**: 과도한 데이터 반환 방지 (최대 1000행)
+- **세밀한 권한 제어**: 각 분석 도구별 개별 활성화/비활성화
 
 **지원되는 SQL 명령어**:
-- `SELECT` - 데이터 조회 및 분석
-- `SHOW` - 데이터베이스/테이블/인덱스 정보 조회
-- `DESCRIBE` / `DESC` - 테이블 구조 및 컬럼 정보
-- `EXPLAIN` - 쿼리 실행 계획 및 성능 분석
+- `SELECT` - 데이터 조회 및 분석 (항상 허용)
+- `SHOW` - 데이터베이스/테이블/인덱스 정보 조회 (항상 허용)
+- `DESCRIBE` / `DESC` - 테이블 구조 및 컬럼 정보 (항상 허용)
+- `EXPLAIN` - 쿼리 실행 계획 및 성능 분석 (선택적 허용, 기본값: 허용)
+- `ANALYZE` - 테이블 통계 분석 및 업데이트 (선택적 허용, 기본값: 비허용)
 
 ## 요구사항
 
@@ -91,11 +94,18 @@ npx -y @smithery/cli install @cano721/mysql-mcp-server --client claude
 
 서버는 다음 환경 변수가 필요합니다:
 
+**필수 환경 변수:**
 - `MYSQL_HOST`: 데이터베이스 서버 호스트명
-- `MYSQL_PORT`: 데이터베이스 서버 포트 (기본값: 3306)
 - `MYSQL_USER`: 데이터베이스 사용자명
-- `MYSQL_PASSWORD`: 데이터베이스 비밀번호 (선택사항, 보안 연결에 권장)
-- `MYSQL_DATABASE`: 기본 데이터베이스명 (선택사항)
+
+**선택적 환경 변수:**
+- `MYSQL_PORT`: 데이터베이스 서버 포트 (기본값: 3306)
+- `MYSQL_PASSWORD`: 데이터베이스 비밀번호 (보안 연결에 권장)
+- `MYSQL_DATABASE`: 기본 데이터베이스명
+
+**보안 설정:**
+- `MYSQL_ALLOW_EXPLAIN`: EXPLAIN 쿼리 허용 여부 (기본값: true, 비활성화: false)
+- `MYSQL_ALLOW_ANALYZE`: ANALYZE 쿼리 허용 여부 (기본값: false, 활성화: true)
 
 ### 3. MCP 설정에 추가
 
@@ -257,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
 {
@@ -290,7 +312,9 @@ MySQL 연결 풀 동작을 더 세밀하게 제어하려면 추가 매개변수
         "MYSQL_QUEUE_LIMIT": "0",
         "MYSQL_CONNECT_TIMEOUT": "10000",
         "MYSQL_IDLE_TIMEOUT": "60000",
-        "MYSQL_MAX_IDLE": "10"
+        "MYSQL_MAX_IDLE": "10",
+        "MYSQL_ALLOW_EXPLAIN": "true",
+        "MYSQL_ALLOW_ANALYZE": "false"
       },
       "disabled": false,
       "autoApprove": []
@@ -306,6 +330,8 @@ MySQL 연결 풀 동작을 더 세밀하게 제어하려면 추가 매개변수
 - `MYSQL_CONNECT_TIMEOUT`: 연결 타임아웃을 밀리초 단위로 조정 (기본값: 10000)
 - `MYSQL_IDLE_TIMEOUT`: 연결이 해제되기 전까지 유휴 상태로 있을 수 있는 시간 (밀리초 단위)
 - `MYSQL_MAX_IDLE`: 풀에 유지할 최대 유휴 연결 수 설정
+- `MYSQL_ALLOW_EXPLAIN`: EXPLAIN 쿼리 허용 여부 (기본값: true)
+- `MYSQL_ALLOW_ANALYZE`: ANALYZE 쿼리 허용 여부 (기본값: false)
 
 ## 테스트
 

package/build/connection.js

@@ -102,6 +102,9 @@ export function getConfigFromEnv() {
     const connectTimeoutStr = process.env.MYSQL_CONNECT_TIMEOUT;
     const idleTimeoutStr = process.env.MYSQL_IDLE_TIMEOUT;
     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)
@@ -113,6 +116,10 @@ export function getConfigFromEnv() {
     const connectTimeout = connectTimeoutStr ? parseInt(connectTimeoutStr, 10) : undefined;
     const idleTimeout = idleTimeoutStr ? parseInt(idleTimeoutStr, 10) : undefined;
     const maxIdle = maxIdleStr ? parseInt(maxIdleStr, 10) : undefined;
+    console.error('[Setup] Security settings:', {
+        allowExplain,
+        allowAnalyze
+    });
     return {
         host,
         port,

package/build/index.js

@@ -46,6 +46,18 @@ const server = new Server({
  * Handler that lists available tools for MySQL database access
  */
 server.setRequestHandler(ListToolsRequestSchema, async () => {
+    // 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: [
             {
@@ -97,7 +109,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     properties: {
                         query: {
                             type: "string",
-                            description: "SQL query (only SELECT, SHOW, DESCRIBE, and EXPLAIN statements are allowed)"
+                            description: commandsDescription
                         },
                         database: {
                             type: "string",

package/build/validators.js

@@ -8,7 +8,11 @@ const ALLOWED_COMMANDS = [
     'SHOW',
     'DESCRIBE',
     'DESC',
+];
+// Optional commands that can be enabled/disabled
+const OPTIONAL_COMMANDS = [
     'EXPLAIN',
+    'ANALYZE',
 ];
 // List of disallowed SQL commands (write operations)
 const DISALLOWED_COMMANDS = [
@@ -34,6 +38,23 @@ const DISALLOWED_COMMANDS = [
     'COMMIT',
     'ROLLBACK',
 ];
+/**
+ * Get allowed commands based on environment configuration
+ */
+function getAllowedCommands() {
+    const allowedCommands = [...ALLOWED_COMMANDS];
+    // Check if EXPLAIN is enabled (default: true)
+    const allowExplain = process.env.MYSQL_ALLOW_EXPLAIN !== 'false';
+    if (allowExplain) {
+        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;
+}
 /**
  * Validates if a SQL query is read-only
  * @param query SQL query to validate
@@ -47,8 +68,10 @@ export function isReadOnlyQuery(query) {
         .replace(/\s+/g, ' ') // Normalize whitespace
         .trim()
         .toUpperCase();
+    // Get currently allowed commands
+    const allowedCommands = getAllowedCommands();
     // Check if query starts with an allowed command
-    const startsWithAllowed = ALLOWED_COMMANDS.some(cmd => normalizedQuery.startsWith(cmd + ' ') || normalizedQuery === cmd);
+    const startsWithAllowed = allowedCommands.some(cmd => normalizedQuery.startsWith(cmd + ' ') || normalizedQuery === cmd);
     // Check if query contains any disallowed commands
     const containsDisallowed = DISALLOWED_COMMANDS.some(cmd => {
         const regex = new RegExp(`(^|\\s)${cmd}(\\s|$)`);
@@ -73,7 +96,8 @@ export function validateQuery(query) {
     }
     if (!isReadOnlyQuery(query)) {
         console.error('[Validator] Query rejected: not read-only');
-        throw new Error('Only read-only queries are allowed (SELECT, SHOW, DESCRIBE, EXPLAIN)');
+        const allowedCommands = getAllowedCommands();
+        throw new Error(`Only read-only queries are allowed (${allowedCommands.join(', ')})`);
     }
     console.error('[Validator] Query validated as read-only');
 }

package/package.json

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