redash-mcp 2.1.0 → 2.2.1

package/.gitattributes

@@ -0,0 +1 @@
+package-lock.json linguist-generated=true

package/dist/index.js

@@ -2,6 +2,8 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+import { analyzeQuery } from "./sql-guard.js";
+import { getCached, setCached } from "./query-cache.js";
 if (process.argv[2] === "setup") {
     const { main } = await import("./setup.js");
     await main();
@@ -127,17 +129,52 @@ server.tool("get_table_columns", "테이블의 컬럼명과 타입을 반환합
     };
 });
 // ─── Query Execution ──────────────────────────────────────────────────────────
+const DEFAULT_MAX_AGE = parseInt(process.env.REDASH_DEFAULT_MAX_AGE ?? "0", 10) || 0;
 server.tool("run_query", "SQL을 데이터소스에 직접 실행하고 결과를 반환합니다. SQL 작성 전 list_tables → get_table_columns로 스키마를 먼저 확인하세요.", {
     data_source_id: z.number().describe("list_data_sources로 확인한 데이터소스 ID"),
     query: z.string().describe("실행할 SQL 쿼리"),
-    max_age: z.number().optional().default(0).describe("캐시 유지 시간(초), 0이면 항상 새로 실행"),
+    max_age: z.number().optional().describe("Redash 캐시 유지 시간(초). 미지정 시 REDASH_DEFAULT_MAX_AGE 환경변수 사용"),
     max_rows: z.number().optional().default(100).describe("반환할 최대 행 수 (기본 100)"),
     format: z.enum(["table", "json"]).optional().default("table").describe("결과 포맷: table(마크다운) 또는 json"),
     timeout_secs: z.number().optional().default(30).describe("쿼리 실행 타임아웃(초)"),
 }, async ({ data_source_id, query, max_age, max_rows, format, timeout_secs }) => {
+    // 1. SQL 안전 가드
+    const guard = analyzeQuery(query);
+    if (guard.blocked) {
+        return { content: [{ type: "text", text: guard.message }] };
+    }
+    // auto-LIMIT이 적용된 경우 변환된 쿼리 사용
+    const effectiveQuery = guard.modifiedQuery ?? query;
+    const effectiveMaxAge = max_age ?? DEFAULT_MAX_AGE;
+    // 2. MCP 레이어 캐시 조회
+    const cached = getCached(data_source_id, effectiveQuery);
+    if (cached) {
+        const { rows, columns, warningPrefix } = cached;
+        const displayRows = rows.slice(0, max_rows);
+        const truncated = rows.length > max_rows
+            ? `\n⚠️ 전체 ${rows.length}행 중 ${max_rows}행만 표시합니다.`
+            : "";
+        let body;
+        if (format === "json") {
+            body = JSON.stringify(displayRows, null, 2);
+        }
+        else {
+            body = formatAsMarkdownTable(columns, displayRows);
+        }
+        const cacheNote = "📦 MCP 캐시에서 반환된 결과입니다.\n\n";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${warningPrefix}${cacheNote}총 ${rows.length}행 | 컬럼: ${columns.join(", ")}${truncated}\n\n${body}`,
+                },
+            ],
+        };
+    }
+    // 3. Redash API 호출
     const res = await redashFetch("/query_results", {
         method: "POST",
-        body: JSON.stringify({ data_source_id, query, max_age }),
+        body: JSON.stringify({ data_source_id, query: effectiveQuery, max_age: effectiveMaxAge }),
     });
     let result;
     if (res.job) {
@@ -149,6 +186,9 @@ server.tool("run_query", "SQL을 데이터소스에 직접 실행하고 결과
     const qr = result.query_result;
     const rows = qr.data.rows;
     const columns = qr.data.columns.map((c) => c.name);
+    // 4. MCP 캐시에 저장
+    const warningPrefix = guard.message ? `${guard.message}\n\n` : "";
+    setCached(data_source_id, effectiveQuery, { rows, columns, warningPrefix });
     const displayRows = rows.slice(0, max_rows);
     const truncated = rows.length > max_rows
         ? `\n⚠️ 전체 ${rows.length}행 중 ${max_rows}행만 표시합니다.`
@@ -164,7 +204,7 @@ server.tool("run_query", "SQL을 데이터소스에 직접 실행하고 결과
         content: [
             {
                 type: "text",
-                text: `총 ${rows.length}행 | 컬럼: ${columns.join(", ")}${truncated}\n\n${body}`,
+                text: `${warningPrefix}총 ${rows.length}행 | 컬럼: ${columns.join(", ")}${truncated}\n\n${body}`,
             },
         ],
     };

package/dist/query-cache.js

@@ -0,0 +1,74 @@
+import { createHash } from "crypto";
+const cache = new Map();
+let totalSizeBytes = 0;
+function getCacheTtlMs() {
+    const ttl = parseInt(process.env.REDASH_MCP_CACHE_TTL ?? "300", 10);
+    return (isNaN(ttl) ? 300 : ttl) * 1000;
+}
+function getMaxSizeBytes() {
+    const mb = parseInt(process.env.REDASH_MCP_CACHE_MAX_MB ?? "50", 10);
+    return (isNaN(mb) ? 50 : mb) * 1024 * 1024;
+}
+function normalizeSQL(sql) {
+    return sql
+        .replace(/--[^\n]*/g, " ")
+        .replace(/\/\*[\s\S]*?\*\//g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .toLowerCase();
+}
+function makeCacheKey(dataSourceId, sql) {
+    return createHash("sha256")
+        .update(`${dataSourceId}:${normalizeSQL(sql)}`)
+        .digest("hex");
+}
+function roughSize(obj) {
+    return JSON.stringify(obj).length * 2;
+}
+export function getCached(dataSourceId, sql) {
+    const ttl = getCacheTtlMs();
+    if (ttl === 0)
+        return null;
+    const key = makeCacheKey(dataSourceId, sql);
+    const entry = cache.get(key);
+    if (!entry)
+        return null;
+    if (Date.now() - entry.ts > ttl) {
+        totalSizeBytes -= entry.size;
+        cache.delete(key);
+        return null;
+    }
+    return entry.result;
+}
+export function setCached(dataSourceId, sql, result) {
+    const ttl = getCacheTtlMs();
+    if (ttl === 0)
+        return;
+    const maxSize = getMaxSizeBytes();
+    const size = roughSize(result);
+    // 단일 결과가 전체 한도의 20% 초과 시 캐시하지 않음
+    if (size > maxSize * 0.2)
+        return;
+    // 한도 초과 시 오래된 항목부터 제거
+    while (totalSizeBytes + size > maxSize && cache.size > 0) {
+        const oldestKey = cache.keys().next().value;
+        if (!oldestKey)
+            break;
+        const old = cache.get(oldestKey);
+        totalSizeBytes -= old.size;
+        cache.delete(oldestKey);
+    }
+    const key = makeCacheKey(dataSourceId, sql);
+    const existing = cache.get(key);
+    if (existing)
+        totalSizeBytes -= existing.size;
+    cache.set(key, { result, ts: Date.now(), size });
+    totalSizeBytes += size;
+}
+export function getCacheStats() {
+    return {
+        entries: cache.size,
+        sizeMb: (totalSizeBytes / 1024 / 1024).toFixed(2),
+        ttlSecs: getCacheTtlMs() / 1000,
+    };
+}

package/dist/setup.js

@@ -76,6 +76,65 @@ export async function main() {
         p.cancel("설치가 취소되었습니다.");
         process.exit(0);
     }
+    // ── 안전 모드 설정 ────────────────────────────────────────────────────────
+    const safetyMode = await p.select({
+        message: "SQL 안전 모드를 선택하세요",
+        options: [
+            { value: "warn", label: "warn   — 위험 쿼리 경고 후 실행 (권장)" },
+            { value: "strict", label: "strict — 위험 쿼리 차단" },
+            { value: "off", label: "off    — 제한 없음 (관리자 전용)" },
+        ],
+        initialValue: "warn",
+    });
+    if (p.isCancel(safetyMode)) {
+        p.cancel("설치가 취소되었습니다.");
+        process.exit(0);
+    }
+    const autoLimitRaw = await p.text({
+        message: "자동 LIMIT 값을 입력하세요 (0 = 비활성화)",
+        placeholder: "1000",
+        initialValue: "1000",
+        validate(value) {
+            if (!value)
+                return undefined;
+            if (isNaN(parseInt(value, 10)))
+                return "숫자를 입력해주세요.";
+        },
+    });
+    if (p.isCancel(autoLimitRaw)) {
+        p.cancel("설치가 취소되었습니다.");
+        process.exit(0);
+    }
+    const defaultMaxAgeRaw = await p.text({
+        message: "Redash 캐시 유지 시간을 입력하세요 (초, 0 = 항상 새로 실행)",
+        placeholder: "600",
+        initialValue: "600",
+        validate(value) {
+            if (!value)
+                return undefined;
+            if (isNaN(parseInt(value, 10)))
+                return "숫자를 입력해주세요.";
+        },
+    });
+    if (p.isCancel(defaultMaxAgeRaw)) {
+        p.cancel("설치가 취소되었습니다.");
+        process.exit(0);
+    }
+    const mcpCacheTtlRaw = await p.text({
+        message: "MCP 레이어 캐시 TTL을 입력하세요 (초, 0 = 비활성화)",
+        placeholder: "300",
+        initialValue: "300",
+        validate(value) {
+            if (!value)
+                return undefined;
+            if (isNaN(parseInt(value, 10)))
+                return "숫자를 입력해주세요.";
+        },
+    });
+    if (p.isCancel(mcpCacheTtlRaw)) {
+        p.cancel("설치가 취소되었습니다.");
+        process.exit(0);
+    }
     const url = redashUrl.replace(/\/$/, "");
     const npxPath = findNpxPath();
     const mcpEntry = {
@@ -84,6 +143,10 @@ export async function main() {
         env: {
             REDASH_URL: url,
             REDASH_API_KEY: apiKey,
+            REDASH_SAFETY_MODE: String(safetyMode),
+            REDASH_AUTO_LIMIT: String(autoLimitRaw || "1000"),
+            REDASH_DEFAULT_MAX_AGE: String(defaultMaxAgeRaw || "600"),
+            REDASH_MCP_CACHE_TTL: String(mcpCacheTtlRaw || "300"),
         },
     };
     const s = p.spinner();

package/dist/sql-guard.js

@@ -0,0 +1,159 @@
+function getConfig() {
+    const raw = process.env.REDASH_SAFETY_MODE ?? "warn";
+    const mode = ["off", "warn", "strict"].includes(raw) ? raw : "warn";
+    return {
+        mode,
+        disablePii: process.env.REDASH_SAFETY_DISABLE_PII === "true",
+        disableCost: process.env.REDASH_SAFETY_DISABLE_COST === "true",
+        autoLimit: parseInt(process.env.REDASH_AUTO_LIMIT ?? "0", 10) || 0,
+    };
+}
+function normalizeForAnalysis(sql) {
+    return sql
+        .replace(/--[^\n]*/g, " ")
+        .replace(/\/\*[\s\S]*?\*\//g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .toUpperCase();
+}
+function hasWhere(sql) {
+    return /\bWHERE\b/.test(sql);
+}
+function hasLimit(sql) {
+    return /\bLIMIT\b/.test(sql);
+}
+function isSelect(sql) {
+    return /^\s*(SELECT|WITH)\b/i.test(sql);
+}
+function injectLimit(sql, limit) {
+    if (/\bLIMIT\b/i.test(sql))
+        return sql;
+    if (!isSelect(sql))
+        return sql;
+    return `${sql.trimEnd()} LIMIT ${limit}`;
+}
+export function analyzeQuery(sql) {
+    const config = getConfig();
+    if (config.mode === "off") {
+        return { blocked: false, warnings: [], message: "" };
+    }
+    const upper = normalizeForAnalysis(sql);
+    const warnings = [];
+    let modifiedQuery;
+    // ── Destructive (차단: warn/strict 모두) ────────────────────────────────────
+    if (/\bDROP\s+(TABLE|DATABASE|SCHEMA|VIEW|INDEX|FUNCTION)\b/.test(upper)) {
+        return {
+            blocked: true,
+            warnings: [],
+            message: "🚫 쿼리가 차단되었습니다.\n\n사유: DROP 문은 데이터/스키마를 영구 삭제합니다.\n규칙: DESTRUCTIVE / DROP\n\n해제가 필요하다면 REDASH_SAFETY_MODE=off 로 설정하세요.",
+        };
+    }
+    if (/\bTRUNCATE\b/.test(upper)) {
+        return {
+            blocked: true,
+            warnings: [],
+            message: "🚫 쿼리가 차단되었습니다.\n\n사유: TRUNCATE 문은 전체 테이블 데이터를 삭제합니다.\n규칙: DESTRUCTIVE / TRUNCATE",
+        };
+    }
+    if (/\bALTER\s+TABLE\b/.test(upper)) {
+        return {
+            blocked: true,
+            warnings: [],
+            message: "🚫 쿼리가 차단되었습니다.\n\n사유: ALTER TABLE은 스키마 변경으로 사전 협의가 필요합니다.\n규칙: DESTRUCTIVE / ALTER_TABLE",
+        };
+    }
+    if (/\b(GRANT|REVOKE)\b/.test(upper)) {
+        return {
+            blocked: true,
+            warnings: [],
+            message: "🚫 쿼리가 차단되었습니다.\n\n사유: GRANT/REVOKE는 권한 변경으로 허용되지 않습니다.\n규칙: DESTRUCTIVE / PRIVILEGE_CHANGE",
+        };
+    }
+    if (/\bDELETE\s+FROM\b/.test(upper) && !hasWhere(upper)) {
+        return {
+            blocked: true,
+            warnings: [],
+            message: "🚫 쿼리가 차단되었습니다.\n\n사유: WHERE 조건 없는 DELETE는 전체 데이터를 삭제합니다.\n규칙: DESTRUCTIVE / DELETE_WITHOUT_WHERE\n\n안전한 예시:\n  DELETE FROM orders WHERE created_at < '2024-01-01'",
+        };
+    }
+    if (/\bUPDATE\b/.test(upper) && /\bSET\b/.test(upper) && !hasWhere(upper)) {
+        return {
+            blocked: true,
+            warnings: [],
+            message: "🚫 쿼리가 차단되었습니다.\n\n사유: WHERE 조건 없는 UPDATE는 전체 데이터를 수정합니다.\n규칙: DESTRUCTIVE / UPDATE_WITHOUT_WHERE\n\n안전한 예시:\n  UPDATE orders SET status = 'cancelled' WHERE created_at < '2024-01-01'",
+        };
+    }
+    // DELETE/UPDATE with WHERE — 경고만
+    if (/\bDELETE\s+FROM\b/.test(upper)) {
+        warnings.push("[DESTRUCTIVE] DELETE 쿼리입니다. WHERE 조건을 다시 확인하세요.");
+    }
+    if (/\bUPDATE\b/.test(upper) && /\bSET\b/.test(upper)) {
+        warnings.push("[DESTRUCTIVE] UPDATE 쿼리입니다. WHERE 조건을 다시 확인하세요.");
+    }
+    // ── Cost (warn: 경고 후 실행, strict: 차단) ────────────────────────────────
+    if (!config.disableCost && isSelect(sql)) {
+        const hasSelectStar = /SELECT\s+\*/.test(upper) || /SELECT\s+[\w.]+\.\*/.test(upper);
+        const noWhere = !hasWhere(upper);
+        const noLimit = !hasLimit(upper);
+        if (hasSelectStar) {
+            warnings.push("[COST] SELECT *를 사용하고 있습니다. 필요한 컬럼만 명시하면 BigQuery 스캔 비용을 줄일 수 있습니다.");
+        }
+        if (noWhere) {
+            warnings.push("[COST] WHERE 조건이 없습니다. 날짜 또는 조건 필터를 추가하는 것을 권장합니다.");
+        }
+        if (noLimit) {
+            if (config.autoLimit > 0) {
+                modifiedQuery = injectLimit(sql, config.autoLimit);
+                warnings.push(`[COST] LIMIT이 없어 자동으로 LIMIT ${config.autoLimit}을 추가했습니다. 전체 조회가 필요하면 명시적으로 LIMIT을 지정하세요.`);
+            }
+            else {
+                warnings.push("[COST] LIMIT이 없습니다. 대용량 테이블에서는 전체 데이터가 반환되어 비용이 발생할 수 있습니다.");
+            }
+        }
+        if (config.mode === "strict") {
+            const costWarnings = warnings.filter((w) => w.startsWith("[COST]"));
+            if (costWarnings.length > 0) {
+                return {
+                    blocked: true,
+                    warnings: [],
+                    message: `🚫 쿼리가 차단되었습니다 (strict 모드).\n\n${costWarnings.join("\n")}\n\nwarn 모드로 변경하려면 REDASH_SAFETY_MODE=warn 으로 설정하세요.`,
+                };
+            }
+        }
+    }
+    // ── PII (warn: 경고 후 실행, strict: 차단) ────────────────────────────────
+    if (!config.disablePii) {
+        const piiPatterns = [
+            "EMAIL",
+            "PHONE",
+            "PASSWORD",
+            "PASSWD",
+            "SSN",
+            "SOCIAL_SECURITY",
+            "CREDIT_CARD",
+            "CARD_NUMBER",
+            "주민",
+            "휴대폰",
+            "핸드폰",
+            "생년월일",
+        ];
+        const matched = piiPatterns.filter((k) => upper.includes(k));
+        if (matched.length > 0) {
+            warnings.push(`[PII] 민감 정보 관련 컬럼이 감지되었습니다: ${matched.join(", ")}. 개인정보 처리 규정을 확인하세요.`);
+        }
+        if (config.mode === "strict") {
+            const piiWarnings = warnings.filter((w) => w.startsWith("[PII]"));
+            if (piiWarnings.length > 0) {
+                return {
+                    blocked: true,
+                    warnings: [],
+                    message: `🚫 쿼리가 차단되었습니다 (strict 모드).\n\n${piiWarnings.join("\n")}\n\nwarn 모드로 변경하려면 REDASH_SAFETY_MODE=warn 으로 설정하세요.`,
+                };
+            }
+        }
+    }
+    const message = warnings.length > 0
+        ? `⚠️ 안전 경고 (쿼리는 실행됩니다)\n\n${warnings.join("\n")}\n\n---`
+        : "";
+    return { blocked: false, warnings, message, modifiedQuery };
+}

package/docs/sql-safety-guard.md

@@ -0,0 +1,197 @@
+# SQL Safety Guard — 설계 문서
+
+## 개요
+
+`redash-mcp`에 SQL 안전 가드 레이어를 추가하여 MCP를 통해 실행되는 쿼리로 인한
+비용 발생, 데이터 손실, 개인정보 노출을 사전에 방지한다.
+
+---
+
+## 배경 및 목적
+
+- Redash를 MCP로 연결하면 AI가 자동으로 쿼리를 생성·실행하는 환경이 된다
+- 사용자가 SQL을 직접 검토하지 않는 경우가 많아 위험 쿼리가 그대로 실행될 수 있음
+- BigQuery는 스캔한 데이터 용량 기준으로 과금되어 예상치 못한 비용 발생 가능
+- AI가 생성한 쿼리에 DROP, DELETE 등이 포함될 경우 데이터 손실 위험
+
+---
+
+## 아키텍처
+
+### 위치
+
+```
+AI (Claude)
+    ↓ tool call
+run_query (MCP 도구)
+    ↓
+[SQL Safety Guard]  ← 여기에 삽입
+    ↓ 통과 시
+Redash API
+    ↓
+BigQuery
+```
+
+### 패턴
+
+미들웨어/인터셉터 패턴. `run_query` 핸들러 내부에서 Redash API 호출 전에 실행.
+
+```typescript
+// src/sql-guard.ts
+export function analyzeQuery(sql: string, mode: SafetyMode): SafetyResult
+
+// src/index.ts (run_query 핸들러)
+const result = analyzeQuery(query, safetyMode);
+if (result.blocked) {
+  return { content: [{ type: "text", text: result.message }] };
+}
+// ... Redash API 호출
+```
+
+---
+
+## 감지 규칙
+
+### Category 1: 데이터 파괴 (Destructive) — 기본: 차단
+
+| 규칙 | 패턴 예시 | 기본 동작 |
+|---|---|---|
+| DDL 변경 | `DROP TABLE`, `TRUNCATE`, `ALTER TABLE` | 차단 |
+| 조건 없는 삭제 | `DELETE FROM table` (WHERE 없음) | 차단 |
+| 조건 없는 수정 | `UPDATE table SET ...` (WHERE 없음) | 차단 |
+| 권한 변경 | `GRANT`, `REVOKE` | 차단 |
+
+### Category 2: 비용 위험 (Cost) — 기본: 경고
+
+| 규칙 | 패턴 예시 | 기본 동작 |
+|---|---|---|
+| WHERE 없는 SELECT | `SELECT ... FROM table` (WHERE 없음) | 경고 |
+| SELECT * | `SELECT * FROM ...` | 경고 |
+| 집계 없는 대량 조회 | 조건 없이 raw 데이터 전체 조회 | 경고 |
+
+### Category 3: 개인정보 (PII) — 기본: 경고
+
+| 규칙 | 감지 컬럼명 키워드 | 기본 동작 |
+|---|---|---|
+| 민감 컬럼 SELECT | `email`, `phone`, `password`, `ssn`, `social`, `주민`, `휴대폰`, `핸드폰` | 경고 |
+
+> PII 규칙은 컬럼명 기반 휴리스틱이며 오탐이 발생할 수 있다.
+> 환경변수로 비활성화 가능.
+
+---
+
+## 동작 모드
+
+```
+REDASH_SAFETY_MODE=off|warn|strict
+```
+
+| 모드 | Destructive | Cost | PII |
+|---|---|---|---|
+| `off` | 통과 | 통과 | 통과 |
+| `warn` (기본) | **차단** | 경고 후 실행 | 경고 후 실행 |
+| `strict` | **차단** | **차단** | **차단** |
+
+- Destructive는 모든 모드에서 `warn` 이상이면 차단 (데이터 손실은 되돌릴 수 없음)
+- `off`는 완전히 비활성화가 필요한 경우를 위해 제공 (내부 관리자용 등)
+
+---
+
+## 환경변수
+
+| 변수 | 기본값 | 설명 |
+|---|---|---|
+| `REDASH_SAFETY_MODE` | `warn` | 전체 안전 모드 |
+| `REDASH_SAFETY_DISABLE_PII` | `false` | PII 감지 비활성화 |
+| `REDASH_SAFETY_DISABLE_COST` | `false` | 비용 경고 비활성화 |
+
+---
+
+## 응답 포맷
+
+### 차단 시
+
+```
+🚫 쿼리가 차단되었습니다.
+
+사유: WHERE 조건 없이 전체 테이블을 수정하는 쿼리는 실행할 수 없습니다.
+규칙: DESTRUCTIVE / UPDATE_WITHOUT_WHERE
+
+안전한 쿼리 예시:
+  UPDATE orders SET status = 'cancelled' WHERE created_at < '2024-01-01'
+
+안전 모드 해제가 필요하다면 REDASH_SAFETY_MODE=off 로 설정하세요.
+```
+
+### 경고 시 (warn 모드)
+
+```
+⚠️ 안전 경고 (쿼리는 실행됩니다)
+
+[COST] SELECT *를 사용하고 있습니다. 필요한 컬럼만 명시하면 비용을 줄일 수 있습니다.
+[COST] WHERE 조건이 없습니다. 날짜 또는 조건 필터를 추가하는 것을 권장합니다.
+
+---
+(쿼리 결과)
+```
+
+---
+
+## 파일 구조
+
+```
+src/
+  index.ts          # 기존 — run_query에 가드 연결
+  sql-guard.ts      # 신규 — 안전 가드 핵심 로직
+  setup.ts          # 기존 — 설치 마법사에 SAFETY_MODE 설정 추가
+```
+
+---
+
+## setup 마법사 변경
+
+```
+? BigQuery 안전 모드를 선택하세요
+  ○ off    — 제한 없음 (관리자 전용)
+  ● warn   — 위험 패턴 경고 후 실행 (권장)
+  ○ strict — 위험 쿼리 차단
+
+? 개인정보(PII) 컬럼 감지를 활성화하시겠습니까?
+  ● 예 / ○ 아니오
+```
+
+---
+
+## 구현 범위 (v2.2.0)
+
+### 포함
+- [x] Destructive 쿼리 차단 (DDL, DELETE/UPDATE without WHERE)
+- [x] Cost 경고/차단 (WHERE 없는 SELECT, SELECT *)
+- [x] PII 컬럼 경고 (컬럼명 기반)
+- [x] `REDASH_SAFETY_MODE` 환경변수
+- [x] setup 마법사 안전 모드 설정 추가
+- [x] 단위 테스트 (vitest)
+
+### 제외 (추후 검토)
+- Cartesian JOIN 감지 (SQL 파서 필요, 복잡도 높음)
+- 쿼리 실행 횟수 기반 Rate limiting (상태 관리 필요)
+- 실제 BQ 스캔 바이트 추정 (BQ 직접 접근 불가)
+
+---
+
+## 공식 플러그인 등록
+
+### MCP 공식 레지스트리
+- `modelcontextprotocol/servers` GitHub 레포에 PR 제출
+- 요건: npm 패키지, README, 설치 가이드
+
+### Claude Desktop
+- 현재 Claude Desktop 플러그인 = MCP 서버
+- 공식 디렉토리 등록은 Anthropic 신청 필요 (초대제 운영 중)
+- 단기적으로는 MCP 커뮤니티 레지스트리 등록으로 대응
+
+### 등록 준비 체크리스트
+- [ ] README 영문화 (설치, 환경변수, 도구 목록)
+- [ ] 라이선스 명시 (MIT)
+- [ ] 버전 관리 전략 (semver)
+- [ ] CHANGELOG 작성

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "redash-mcp",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "MCP server for Redash",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/seob717/redash-mcp.git"
+  },
+  "homepage": "https://github.com/seob717/redash-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/seob717/redash-mcp/issues"
+  },
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/.omc/project-memory.json

@@ -1,101 +0,0 @@
-{
-  "version": "1.0.0",
-  "lastScanned": 1772697803610,
-  "projectRoot": "/Users/jiro/WebstormProjects/jiro-tools/redash-mcp",
-  "techStack": {
-    "languages": [
-      {
-        "name": "JavaScript/TypeScript",
-        "version": null,
-        "confidence": "high",
-        "markers": [
-          "package.json"
-        ]
-      },
-      {
-        "name": "TypeScript",
-        "version": null,
-        "confidence": "high",
-        "markers": [
-          "tsconfig.json"
-        ]
-      }
-    ],
-    "frameworks": [],
-    "packageManager": "npm",
-    "runtime": null
-  },
-  "build": {
-    "buildCommand": "npm run build",
-    "testCommand": null,
-    "lintCommand": null,
-    "devCommand": "npm run dev",
-    "scripts": {
-      "build": "tsc",
-      "dev": "tsx src/index.ts",
-      "start": "node dist/index.js"
-    }
-  },
-  "conventions": {
-    "namingStyle": "camelCase",
-    "importStyle": "ES modules",
-    "testPattern": null,
-    "fileOrganization": null
-  },
-  "structure": {
-    "isMonorepo": false,
-    "workspaces": [],
-    "mainDirectories": [
-      "src"
-    ],
-    "gitBranches": null
-  },
-  "customNotes": [],
-  "directoryMap": {
-    "dist": {
-      "path": "dist",
-      "purpose": "Distribution/build output",
-      "fileCount": 1,
-      "lastAccessed": 1772697803604,
-      "keyFiles": [
-        "index.js"
-      ]
-    },
-    "src": {
-      "path": "src",
-      "purpose": "Source code",
-      "fileCount": 1,
-      "lastAccessed": 1772697803604,
-      "keyFiles": [
-        "index.ts"
-      ]
-    }
-  },
-  "hotPaths": [
-    {
-      "path": "src/index.ts",
-      "accessCount": 23,
-      "lastAccessed": 1772762087285,
-      "type": "file"
-    },
-    {
-      "path": "package.json",
-      "accessCount": 18,
-      "lastAccessed": 1772761975801,
-      "type": "file"
-    },
-    {
-      "path": "src/setup.ts",
-      "accessCount": 9,
-      "lastAccessed": 1772763077204,
-      "type": "file"
-    },
-    {
-      "path": "",
-      "accessCount": 8,
-      "lastAccessed": 1772760488146,
-      "type": "directory"
-    }
-  ],
-  "userDirectives": []
-}

package/.omc/sessions/0450b0c4-f994-42f3-afd3-8f1b23f25ad6.json

@@ -1,8 +0,0 @@
-{
-  "session_id": "0450b0c4-f994-42f3-afd3-8f1b23f25ad6",
-  "ended_at": "2026-03-05T08:30:17.840Z",
-  "reason": "other",
-  "agents_spawned": 4,
-  "agents_completed": 4,
-  "modes_used": []
-}

package/.omc/sessions/0cb3ce10-4e01-4426-8d8f-e76668bcf8eb.json

@@ -1,8 +0,0 @@
-{
-  "session_id": "0cb3ce10-4e01-4426-8d8f-e76668bcf8eb",
-  "ended_at": "2026-03-05T09:54:42.407Z",
-  "reason": "clear",
-  "agents_spawned": 0,
-  "agents_completed": 0,
-  "modes_used": []
-}

package/.omc/sessions/1eaa9d6f-a106-4c32-aad1-96ea536bbc23.json

@@ -1,8 +0,0 @@
-{
-  "session_id": "1eaa9d6f-a106-4c32-aad1-96ea536bbc23",
-  "ended_at": "2026-03-06T01:06:41.433Z",
-  "reason": "other",
-  "agents_spawned": 0,
-  "agents_completed": 0,
-  "modes_used": []
-}

package/.omc/sessions/3a248a8e-825c-4cb7-980b-8b6ef4c75fb6.json

@@ -1,8 +0,0 @@
-{
-  "session_id": "3a248a8e-825c-4cb7-980b-8b6ef4c75fb6",
-  "ended_at": "2026-03-05T09:05:45.287Z",
-  "reason": "other",
-  "agents_spawned": 0,
-  "agents_completed": 0,
-  "modes_used": []
-}

package/.omc/sessions/42043e3e-2800-407f-b1ab-e17206a826e2.json

@@ -1,8 +0,0 @@
-{
-  "session_id": "42043e3e-2800-407f-b1ab-e17206a826e2",
-  "ended_at": "2026-03-05T07:51:30.914Z",
-  "reason": "clear",
-  "agents_spawned": 0,
-  "agents_completed": 0,
-  "modes_used": []
-}

package/.omc/sessions/441cb2ce-7778-43b1-aad0-6f528ce067f5.json

@@ -1,8 +0,0 @@
-{
-  "session_id": "441cb2ce-7778-43b1-aad0-6f528ce067f5",
-  "ended_at": "2026-03-05T09:04:58.705Z",
-  "reason": "other",
-  "agents_spawned": 0,
-  "agents_completed": 0,
-  "modes_used": []
-}

package/.omc/sessions/4a7d0bb3-4702-49c3-ad7d-3a0936365e46.json

@@ -1,8 +0,0 @@
-{
-  "session_id": "4a7d0bb3-4702-49c3-ad7d-3a0936365e46",
-  "ended_at": "2026-03-06T01:52:47.495Z",
-  "reason": "clear",
-  "agents_spawned": 0,
-  "agents_completed": 0,
-  "modes_used": []
-}

package/.omc/sessions/51fddb19-06a4-4491-b751-e46b5d7e04c4.json

@@ -1,8 +0,0 @@
-{
-  "session_id": "51fddb19-06a4-4491-b751-e46b5d7e04c4",
-  "ended_at": "2026-03-06T01:06:42.394Z",
-  "reason": "other",
-  "agents_spawned": 0,
-  "agents_completed": 0,
-  "modes_used": []
-}

package/.omc/sessions/85f46695-2555-4c3d-9b7b-8ed9ab03083a.json

@@ -1,8 +0,0 @@
-{
-  "session_id": "85f46695-2555-4c3d-9b7b-8ed9ab03083a",
-  "ended_at": "2026-03-05T08:23:26.273Z",
-  "reason": "clear",
-  "agents_spawned": 0,
-  "agents_completed": 0,
-  "modes_used": []
-}

package/.omc/sessions/bce5f4fd-c242-4074-b005-37abb59f88d8.json

@@ -1,8 +0,0 @@
-{
-  "session_id": "bce5f4fd-c242-4074-b005-37abb59f88d8",
-  "ended_at": "2026-03-05T04:31:50.081Z",
-  "reason": "other",
-  "agents_spawned": 0,
-  "agents_completed": 0,
-  "modes_used": []
-}

package/.omc/state/agent-replay-0cb3ce10-4e01-4426-8d8f-e76668bcf8eb.jsonl

@@ -1,11 +0,0 @@
-{"t":0,"agent":"system","event":"keyword_detected","keyword":"ultrawork"}
-{"t":0,"agent":"system","event":"mode_change","mode_from":"none","mode_to":"ultrawork"}
-{"t":0,"agent":"af83682","agent_type":"executor","event":"agent_start","parent_mode":"none"}
-{"t":0,"agent":"a5125cc","agent_type":"executor","event":"agent_start","parent_mode":"none"}
-{"t":0,"agent":"a5d466c","agent_type":"executor","event":"agent_start","parent_mode":"none"}
-{"t":0,"agent":"a5125cc","agent_type":"executor","event":"agent_stop","success":true,"duration_ms":19049}
-{"t":0,"agent":"ae89220","agent_type":"executor","event":"agent_start","parent_mode":"none"}
-{"t":0,"agent":"af83682","agent_type":"executor","event":"agent_stop","success":true,"duration_ms":53629}
-{"t":0,"agent":"ae89220","agent_type":"executor","event":"agent_stop","success":true,"duration_ms":29751}
-{"t":0,"agent":"a5d466c","agent_type":"executor","event":"agent_stop","success":true,"duration_ms":43278}
-{"t":0,"agent":"system","event":"skill_invoked","skill_name":"oh-my-claudecode:cancel"}

package/.omc/state/agent-replay-4a7d0bb3-4702-49c3-ad7d-3a0936365e46.jsonl

@@ -1 +0,0 @@
-{"t":0,"agent":"system","event":"skill_invoked","skill_name":"oh-my-claudecode:skill"}

package/.omc/state/hud-state.json

@@ -1,6 +0,0 @@
-{
-  "timestamp": "2026-03-06T01:52:49.266Z",
-  "backgroundTasks": [],
-  "sessionStartTimestamp": "2026-03-06T01:52:47.508Z",
-  "sessionId": "af950aa1-02a2-433d-bf22-7ae432356e6a"
-}

package/.omc/state/hud-stdin-cache.json

@@ -1 +0,0 @@
-{"session_id":"af950aa1-02a2-433d-bf22-7ae432356e6a","transcript_path":"/Users/jiro/.claude/projects/-Users-jiro-WebstormProjects-jiro-tools-redash-mcp/af950aa1-02a2-433d-bf22-7ae432356e6a.jsonl","cwd":"/Users/jiro/WebstormProjects/jiro-tools/redash-mcp","model":{"id":"claude-sonnet-4-6","display_name":"Sonnet 4.6"},"workspace":{"current_dir":"/Users/jiro/WebstormProjects/jiro-tools/redash-mcp","project_dir":"/Users/jiro/WebstormProjects/jiro-tools/redash-mcp","added_dirs":["/Users/jiro/.claude/skills/omc-learned"]},"version":"2.1.69","output_style":{"name":"default"},"cost":{"total_cost_usd":3.3345675000000017,"total_duration_ms":3892454,"total_api_duration_ms":594144,"total_lines_added":271,"total_lines_removed":22},"context_window":{"total_input_tokens":71068,"total_output_tokens":28846,"context_window_size":200000,"current_usage":{"input_tokens":1,"output_tokens":139,"cache_creation_input_tokens":157,"cache_read_input_tokens":52142},"used_percentage":26,"remaining_percentage":74},"exceeds_200k_tokens":false}

package/.omc/state/idle-notif-cooldown.json

@@ -1,3 +0,0 @@
-{
-  "lastSentAt": "2026-03-06T02:16:56.279Z"
-}

package/.omc/state/last-tool-error.json

@@ -1,7 +0,0 @@
-{
-  "tool_name": "Bash",
-  "tool_input_preview": "{\"command\":\"NPM_TOKEN=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 npm whoami --registry=https://registry.npmjs.org/ 2>&1\",\"description\":\"토큰으로 npm 인증 확인\"}",
-  "error": "Exit code 1\nnpm error code E401\nnpm error 401 Unauthorized - GET https://registry.npmjs.org/-/whoami\nnpm error A complete log of this run can be found in: /Users/jiro/.npm/_logs/2026-03-06T02_18_25_687Z-debug-0.log\n\nnpm error code E401\nnpm error 401 Unauthorized - GET https://registry.npmjs.org/-/whoami\nnpm error A complete log of this run can be found in: /Users/jiro/.npm/_logs/2026-03-06T02_18_25_687Z-debug-0.log",
-  "timestamp": "2026-03-06T02:18:26.057Z",
-  "retry_count": 1
-}

package/.omc/state/sessions/0cb3ce10-4e01-4426-8d8f-e76668bcf8eb/cancel-signal-state.json

@@ -1,7 +0,0 @@
-{
-  "active": true,
-  "requested_at": "2026-03-05T09:05:10.781Z",
-  "expires_at": "2026-03-05T09:05:40.781Z",
-  "mode": "ultrawork",
-  "source": "state_clear"
-}