redash-mcp 2.0.4 → 2.1.1

package/dist/index.js

@@ -23,17 +23,27 @@ async function redashFetch(path, options) {
         },
     });
     if (!res.ok) {
-        throw new Error(`Redash API error: ${res.status} ${res.statusText}`);
+        let hint = "";
+        if (res.status === 401)
+            hint = " (REDASH_API_KEY를 확인하세요)";
+        else if (res.status === 403)
+            hint = " (해당 리소스에 대한 접근 권한이 없습니다)";
+        else if (res.status === 404)
+            hint = " (리소스를 찾을 수 없습니다. ID를 확인하세요)";
+        throw new Error(`Redash API error: ${res.status} ${res.statusText}${hint}`);
+    }
+    if (res.status === 204 || res.headers.get("content-length") === "0") {
+        return null;
     }
     return res.json();
 }
 async function pollQueryResult(jobId, timeoutSecs = 30) {
     for (let i = 0; i < timeoutSecs; i++) {
         const job = await redashFetch(`/jobs/${jobId}`);
-        if (job.job.status === 3) {
+        if (job.job.status === 3) { // 3 = success
             return await redashFetch(`/query_results/${job.job.query_result_id}`);
         }
-        if (job.job.status === 4) {
+        if (job.job.status === 4) { // 4 = failure
             throw new Error(`Query failed: ${job.job.error}`);
         }
         await new Promise((r) => setTimeout(r, 1000));
@@ -41,10 +51,11 @@ async function pollQueryResult(jobId, timeoutSecs = 30) {
     throw new Error(`Query timed out after ${timeoutSecs}s`);
 }
 function formatAsMarkdownTable(columns, rows) {
-    const header = `| ${columns.join(" | ")} |`;
+    const escape = (s) => s.replace(/\|/g, "\\|");
+    const header = `| ${columns.map(escape).join(" | ")} |`;
     const separator = `| ${columns.map(() => "---").join(" | ")} |`;
     const body = rows
-        .map((row) => `| ${columns.map((c) => String(row[c] ?? "")).join(" | ")} |`)
+        .map((row) => `| ${columns.map((c) => escape(String(row[c] ?? ""))).join(" | ")} |`)
         .join("\n");
     return `${header}\n${separator}\n${body}`;
 }
@@ -63,7 +74,7 @@ async function fetchSchema(dataSourceId) {
 }
 const server = new McpServer({
     name: "redash-mcp",
-    version: "2.0.1",
+    version: "2.0.2",
 });
 // ─── Data Sources ────────────────────────────────────────────────────────────
 server.tool("list_data_sources", "Redash에 연결된 데이터소스 목록(id, name, type)을 반환합니다. 항상 이 툴을 먼저 호출해 data_source_id를 확인하세요.", {}, async () => {
@@ -183,7 +194,9 @@ server.tool("list_queries", "Redash에 저장된 쿼리 목록을 조회합니
 });
 server.tool("get_query_result", "저장된 Redash 쿼리를 ID로 실행하고 결과를 반환합니다.", {
     query_id: z.number().describe("저장된 쿼리 ID (list_queries로 확인)"),
-}, async ({ query_id }) => {
+    max_rows: z.number().optional().default(100).describe("반환할 최대 행 수 (기본 100)"),
+    format: z.enum(["table", "json"]).optional().default("table").describe("결과 포맷: table(마크다운) 또는 json"),
+}, async ({ query_id, max_rows, format }) => {
     const res = await redashFetch(`/queries/${query_id}/results`, {
         method: "POST",
         body: JSON.stringify({}),
@@ -198,11 +211,22 @@ server.tool("get_query_result", "저장된 Redash 쿼리를 ID로 실행하고
     const qr = result.query_result;
     const rows = qr.data.rows;
     const columns = qr.data.columns.map((c) => c.name);
+    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);
+    }
     return {
         content: [
             {
                 type: "text",
-                text: `쿼리 ID: ${query_id}\n총 ${rows.length}행\n컬럼: ${columns.join(", ")}\n\n${JSON.stringify(rows, null, 2)}`,
+                text: `쿼리 ID: ${query_id}\n총 ${rows.length}행 | 컬럼: ${columns.join(", ")}${truncated}\n\n${body}`,
             },
         ],
     };
@@ -302,16 +326,7 @@ server.tool("fork_query", "기존 쿼리를 복제(fork)합니다.", {
 server.tool("archive_query", "쿼리를 아카이브(삭제)합니다. 복구 불가합니다.", {
     query_id: z.number().describe("아카이브할 쿼리 ID"),
 }, async ({ query_id }) => {
-    const res = await fetch(`${REDASH_URL}/api/queries/${query_id}`, {
-        method: "DELETE",
-        headers: {
-            "Authorization": `Key ${REDASH_API_KEY}`,
-            "Content-Type": "application/json",
-        },
-    });
-    if (!res.ok) {
-        throw new Error(`Redash API error: ${res.status} ${res.statusText}`);
-    }
+    await redashFetch(`/queries/${query_id}`, { method: "DELETE" });
     return {
         content: [{ type: "text", text: `쿼리 ${query_id}가 아카이브되었습니다.` }],
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "redash-mcp",
-  "version": "2.0.4",
+  "version": "2.1.1",
   "description": "MCP server for Redash",
   "type": "module",
   "main": "dist/index.js",

package/.claude/settings.local.json

@@ -1,20 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(git clone:*)",
-      "Bash(npm:*)",
-      "Bash(git push:*)",
-      "WebFetch(domain:registry.npmjs.org)",
-      "Bash(NPM_TOKEN=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 npm publish:*)"
-    ]
-  },
-  "enabledMcpjsonServers": [
-    "context7",
-    "filesystem",
-    "github"
-  ],
-  "sandbox": {
-    "enabled": true,
-    "autoAllowBashIfSandboxed": true
-  }
-}