redash-mcp 3.1.4 → 3.1.5

package/.dockerignore

@@ -0,0 +1,17 @@
+node_modules
+dist
+.git
+.github
+.idea
+.claude
+.claude-plugin
+.omc
+tests
+docs
+*.mcpb
+*.tgz
+*.png
+install.sh
+install.ps1
+.mcpregistry_*
+.DS_Store

package/Dockerfile

@@ -0,0 +1,29 @@
+# Dockerfile for Glama (and other container-based MCP hosts) introspection.
+#
+# redash-mcp is a local stdio MCP server. This image lets a host start the
+# server and answer introspection (tools/list) requests without real Redash
+# credentials — the placeholder env values below only satisfy the startup
+# guard; actual tool calls require real REDASH_URL / REDASH_API_KEY at runtime.
+
+FROM node:20-slim AS build
+WORKDIR /app
+COPY package.json package-lock.json ./
+RUN npm ci
+COPY tsconfig.json ./
+COPY scripts ./scripts
+COPY src ./src
+RUN npm run build
+
+FROM node:20-slim
+WORKDIR /app
+ENV NODE_ENV=production
+COPY package.json package-lock.json ./
+RUN npm ci --omit=dev && npm cache clean --force
+COPY --from=build /app/dist ./dist
+
+# Placeholder credentials so the server boots and answers introspection.
+# Override these with real values to actually use the server.
+ENV REDASH_URL=http://localhost \
+    REDASH_API_KEY=placeholder
+
+ENTRYPOINT ["node", "dist/index.js"]

package/README.ja.md

@@ -3,14 +3,27 @@
 [![npm version](https://img.shields.io/npm/v/redash-mcp.svg)](https://www.npmjs.com/package/redash-mcp)
 [![Downloads](https://img.shields.io/npm/dm/redash-mcp.svg)](https://www.npmjs.com/package/redash-mcp)
 [![Node](https://img.shields.io/node/v/redash-mcp.svg)](https://nodejs.org)
+[![smithery badge](https://smithery.ai/badge/dev-seob717/redash-mcp)](https://smithery.ai/servers/dev-seob717/redash-mcp)
 
 [English](README.md) | [한국어](README.ko.md) | 日本語
 
 > [Redash](https://redash.io) を Claude AI に接続する MCP サーバー — 自然言語でデータを照会し、SQL を実行し、ダッシュボードを管理します。
 
-[機能](#機能) · [インストール](#インストール) · [環境変数](#環境変数) · [使用例](#使用例) · [Privacy](#privacy-policy)
+[なぜ redash-mcp か](#なぜ-redash-mcp-か) · [機能](#機能) · [インストール](#インストール) · [環境変数](#環境変数) · [使用例](#使用例) · [Privacy](#privacy-policy)
 
-> 英語版 README との最終同期: 2026-05-14
+> 英語版 README との最終同期: 2026-06-09
+
+---
+
+## なぜ redash-mcp か?
+
+Redash MCP サーバーは複数あります。このサーバーは、LLM に **本番(production)データ** を安全に扱わせることに重点を置いています:
+
+- **🛡️ SQL セーフティガード** — `DROP`/`TRUNCATE`/`ALTER`、`WHERE` なしの `DELETE`/`UPDATE` をブロック。`strict`/`warn`/`off` モード、PII 検出、自動 `LIMIT` まで備え、実際の Redash を安心して Claude に任せられます。
+- **🧠 BIRD スマートクエリ** — 質問を解析して適切なテーブルを自動選択し、SQL 生成をガイドします（[BIRD text-to-SQL](https://bird-bench.github.io/) 手法ベース）。テーブル選択用の Claude Haiku フォールバックもオプションで利用できます。
+- **⚡ ワンコマンドでセットアップ** — `npx redash-mcp setup` が Claude Desktop / Claude Code の設定を代わりに行います。JSON を手で編集する必要はありません。
+- **🔒 完全ローカル** — Redash インスタンスと直接通信し、API キーとクエリ結果が端末から外に出ることはありません。
+- **📊 エンドツーエンド** — 照会・保存・複製、ダッシュボード、ウィジェット、アラートまで、6 カテゴリ・20 以上のツール。
 
 ---
 
@@ -23,6 +36,12 @@
 | データソース | `list_data_sources` | 接続されたデータソースの一覧を取得 |
 | スキーマ | `list_tables` | テーブル一覧を取得（キーワード検索対応） |
 | スキーマ | `get_table_columns` | テーブルのカラム名と型を取得 |
+| スマートクエリ | `smart_query` | 質問を解析 → テーブルを自動選択 → SQL 生成をガイド (BIRD) |
+| スマートクエリ | `get_bird_config` | 現在有効な BIRD スマートクエリ設定を取得 |
+| スマートクエリ | `evaluate_queries` | 生成された SQL を期待結果と比較評価 |
+| スマートクエリ | `submit_query_feedback` | テーブル選択を改善するためのフィードバックを記録 |
+| スマートクエリ | `manage_few_shot_examples` | BIRD few-shot 例の追加/一覧 |
+| スマートクエリ | `manage_keyword_map` | キーワード→テーブルのマッピングの追加/一覧 |
 | クエリ実行 | `run_query` | SQL を実行して結果を返す |
 | 保存クエリ | `list_queries` | 保存済みクエリの一覧を取得 |
 | 保存クエリ | `get_query` | クエリの詳細（SQL、可視化）を取得 |

package/README.ko.md

@@ -3,14 +3,27 @@
 [![npm version](https://img.shields.io/npm/v/redash-mcp.svg)](https://www.npmjs.com/package/redash-mcp)
 [![Downloads](https://img.shields.io/npm/dm/redash-mcp.svg)](https://www.npmjs.com/package/redash-mcp)
 [![Node](https://img.shields.io/node/v/redash-mcp.svg)](https://nodejs.org)
+[![smithery badge](https://smithery.ai/badge/dev-seob717/redash-mcp)](https://smithery.ai/servers/dev-seob717/redash-mcp)
 
 [English](README.md) | 한국어 | [日本語](README.ja.md)
 
-> [Redash](https://redash.io)를 Claude AI에 연결하는 MCP 서버 — 자연어로 데이터를 조회하고 대시보드를 관리하세요.
+> [Redash](https://redash.io)를 Claude AI에 연결하는 MCP 서버 — 자연어로 데이터를 조회하고, SQL을 실행하고, 대시보드를 관리하세요.
 
-[기능](#기능) · [설치](#설치) · [환경 변수](#환경-변수) · [사용 예시](#사용-예시) · [Privacy](#privacy-policy)
+[왜 redash-mcp인가](#왜-redash-mcp인가) · [기능](#기능) · [설치](#설치) · [환경 변수](#환경-변수) · [사용 예시](#사용-예시) · [Privacy](#privacy-policy)
 
-> 영문 README와 마지막 동기화: 2026-05-14
+> 영문 README와 마지막 동기화: 2026-06-09
+
+---
+
+## 왜 redash-mcp인가?
+
+Redash MCP 서버는 여러 개 있습니다. 이 서버는 LLM이 **운영(production) 데이터**를 안전하게 다루도록 만드는 데 초점을 맞췄습니다:
+
+- **🛡️ SQL 안전 가드** — `DROP`/`TRUNCATE`/`ALTER`, `WHERE` 없는 `DELETE`/`UPDATE`를 차단합니다. `strict`/`warn`/`off` 모드, PII 감지, 자동 `LIMIT`까지 지원해 실제 Redash를 Claude에 안심하고 맡길 수 있습니다.
+- **🧠 BIRD 스마트 쿼리** — 질문을 분석해 적절한 테이블을 자동 선택하고 SQL 생성을 가이드합니다([BIRD text-to-SQL](https://bird-bench.github.io/) 방법론 기반). 테이블 선택용 Claude Haiku 폴백도 선택적으로 지원합니다.
+- **⚡ 한 번의 명령으로 설치** — `npx redash-mcp setup`이 Claude Desktop / Claude Code 설정을 대신 잡아줍니다. JSON을 직접 손댈 필요가 없습니다.
+- **🔒 완전 로컬** — Redash 인스턴스와 직접 통신하며, API 키와 쿼리 결과가 기기를 벗어나지 않습니다.
+- **📊 처음부터 끝까지** — 조회·저장·복제, 대시보드, 위젯, 알림까지 6개 카테고리에 걸친 20개 이상의 툴.
 
 ---
 
@@ -23,6 +36,12 @@
 | 데이터소스 | `list_data_sources` | 연결된 데이터소스 목록 조회 |
 | 스키마 | `list_tables` | 테이블 목록 조회 (키워드 검색 가능) |
 | 스키마 | `get_table_columns` | 테이블 컬럼명 및 타입 조회 |
+| 스마트 쿼리 | `smart_query` | 질문 분석 → 테이블 자동 선택 → SQL 생성 가이드 (BIRD) |
+| 스마트 쿼리 | `get_bird_config` | 현재 적용 중인 BIRD 스마트 쿼리 설정 조회 |
+| 스마트 쿼리 | `evaluate_queries` | 생성된 SQL을 기대 결과와 비교 평가 |
+| 스마트 쿼리 | `submit_query_feedback` | 테이블 선택 개선을 위한 피드백 기록 |
+| 스마트 쿼리 | `manage_few_shot_examples` | BIRD few-shot 예제 추가/조회 |
+| 스마트 쿼리 | `manage_keyword_map` | 키워드→테이블 매핑 추가/조회 |
 | 쿼리 실행 | `run_query` | SQL 직접 실행 후 결과 반환 |
 | 저장 쿼리 | `list_queries` | 저장된 쿼리 목록 조회 |
 | 저장 쿼리 | `get_query` | 쿼리 상세 정보 (SQL, 시각화 등) 조회 |

package/README.md

@@ -3,12 +3,25 @@
 [![npm version](https://img.shields.io/npm/v/redash-mcp.svg)](https://www.npmjs.com/package/redash-mcp)
 [![Downloads](https://img.shields.io/npm/dm/redash-mcp.svg)](https://www.npmjs.com/package/redash-mcp)
 [![Node](https://img.shields.io/node/v/redash-mcp.svg)](https://nodejs.org)
+[![smithery badge](https://smithery.ai/badge/dev-seob717/redash-mcp)](https://smithery.ai/servers/dev-seob717/redash-mcp)
 
 English | [한국어](README.ko.md) | [日本語](README.ja.md)
 
 > MCP server that connects [Redash](https://redash.io) to Claude AI — query data, manage dashboards, and run SQL with natural language.
 
-[Features](#features) · [Install](#installation) · [Env](#environment-variables) · [Examples](#usage-examples) · [Privacy](#privacy-policy)
+[Why](#why-redash-mcp) · [Features](#features) · [Install](#installation) · [Env](#environment-variables) · [Examples](#usage-examples) · [Privacy](#privacy-policy)
+
+---
+
+## Why redash-mcp?
+
+There are several Redash MCP servers. This one is built for letting an LLM touch **production** data safely:
+
+- **🛡️ SQL Safety Guard** — blocks `DROP`/`TRUNCATE`/`ALTER` and `DELETE`/`UPDATE` without `WHERE`; `strict`/`warn`/`off` modes, PII detection, and auto-`LIMIT`. Hand Claude your real Redash without flinching.
+- **🧠 BIRD Smart Query** — analyzes the question, auto-selects the right tables, and guides SQL generation (based on the [BIRD text-to-SQL](https://bird-bench.github.io/) methodology). Optional Claude Haiku fallback for table selection.
+- **⚡ One-command setup** — `npx redash-mcp setup` configures Claude Desktop / Claude Code for you. No hand-editing JSON.
+- **🔒 Fully local** — talks directly to your Redash instance. API key and query results never leave your machine.
+- **📊 End-to-end** — query, save, fork, dashboards, widgets, and alerts — 20+ tools across 6 categories.
 
 ---
 
@@ -21,6 +34,12 @@ English | [한국어](README.ko.md) | [日本語](README.ja.md)
 | Data Sources | `list_data_sources` | List connected data sources |
 | Schema | `list_tables` | List tables (supports keyword search) |
 | Schema | `get_table_columns` | Get column names and types |
+| Smart Query | `smart_query` | Analyze a question, auto-select tables, guide SQL generation (BIRD) |
+| Smart Query | `get_bird_config` | Inspect the active BIRD smart-query configuration |
+| Smart Query | `evaluate_queries` | Evaluate generated SQL against expected results |
+| Smart Query | `submit_query_feedback` | Record feedback to improve future table selection |
+| Smart Query | `manage_few_shot_examples` | Add/list BIRD few-shot examples |
+| Smart Query | `manage_keyword_map` | Add/list keyword→table mappings |
 | Query | `run_query` | Execute SQL and return results |
 | Saved Queries | `list_queries` | List saved queries |
 | Saved Queries | `get_query` | Get query details (SQL, visualizations) |

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": "0.3",
   "name": "redash-mcp",
-  "version": "3.1.4",
+  "version": "3.1.5",
   "description": "MCP server for Redash -- query data, manage dashboards, and run SQL with natural language. 24 tools including BIRD SQL methodology.",
   "long_description": "Connects an MCP client to a Redash instance: list data sources, inspect schemas, run SQL, manage saved queries / dashboards / alerts, and use BIRD SQL helpers (smart_query, keyword maps, few-shot examples, feedback, evaluation). Built-in SQL safety guards flag PII access and expensive scans; safety mode can be tuned per install. **Third-party data flow:** if you also set ANTHROPIC_API_KEY in the shell environment, the BIRD smart_query tool may send table-name lists (never query results or row data) to the Anthropic API as a fallback for table selection. Leave ANTHROPIC_API_KEY unset to disable this entirely.",
   "icon": "icon.png",

package/package.json

@@ -1,17 +1,28 @@
 {
   "name": "redash-mcp",
   "mcpName": "io.github.seob717/redash-mcp",
-  "version": "3.1.4",
-  "description": "MCP server for Redash",
+  "version": "3.1.5",
+  "description": "MCP server that connects Redash to Claude AI — query data, manage dashboards, and run SQL with natural language, with built-in SQL safety guards.",
   "license": "MIT",
   "author": "seob717",
   "keywords": [
     "mcp",
+    "mcp-server",
+    "model-context-protocol",
     "redash",
+    "redash-api",
+    "claude",
+    "claude-ai",
+    "anthropic",
     "sql",
+    "text-to-sql",
+    "llm",
+    "ai",
     "bi",
+    "business-intelligence",
     "dashboard",
-    "model-context-protocol"
+    "data-analytics",
+    "natural-language"
   ],
   "engines": {
     "node": ">=20"

package/smithery.yaml

@@ -0,0 +1,46 @@
+# Smithery configuration for redash-mcp (https://smithery.ai/docs/build/project-config/smithery.yaml)
+# redash-mcp is a local stdio MCP server distributed via npm. Smithery runs it
+# with the user-supplied config below.
+startCommand:
+  type: stdio
+  configSchema:
+    type: object
+    required:
+      - redashUrl
+      - redashApiKey
+    properties:
+      redashUrl:
+        type: string
+        description: "Your Redash instance URL (e.g. https://redash.example.com)"
+      redashApiKey:
+        type: string
+        description: "Your Redash user API key (Redash > Edit Profile > API Key)"
+      safetyMode:
+        type: string
+        enum: ["off", "warn", "strict"]
+        default: "warn"
+        description: "SQL safety level: 'strict' blocks risky queries, 'warn' returns warnings, 'off' disables guards."
+      autoLimit:
+        type: number
+        default: 0
+        description: "Auto-append LIMIT N to queries without one (0 = disabled)."
+      birdEnabled:
+        type: boolean
+        default: true
+        description: "Enable BIRD smart-query tools."
+      anthropicApiKey:
+        type: string
+        description: "Optional. Enables Claude Haiku fallback for table selection in smart_query."
+  commandFunction: |-
+    (config) => ({
+      command: 'npx',
+      args: ['-y', 'redash-mcp'],
+      env: {
+        REDASH_URL: config.redashUrl,
+        REDASH_API_KEY: config.redashApiKey,
+        REDASH_SAFETY_MODE: config.safetyMode ?? 'warn',
+        REDASH_AUTO_LIMIT: String(config.autoLimit ?? 0),
+        REDASH_BIRD_ENABLED: String(config.birdEnabled ?? true),
+        ...(config.anthropicApiKey ? { ANTHROPIC_API_KEY: config.anthropicApiKey } : {})
+      }
+    })