redash-mcp

Redash REST API を読み取り専用でラップする MCP サーバ。唯一の例外として 保存済みクエリの実行（POST /api/queries/{id}/results）のみ許可する。

ツール

• list_queries(q?, page, page_size) — クエリ一覧・検索
• get_query(query_id) — クエリ詳細（api_key は秘匿）
• execute_query(query_id, parameters?, max_age) — クエリ実行 → 行データ
• list_data_sources() — データソース一覧
• get_data_source_schema(data_source_id) — スキーマ
• list_dashboards(q?, page, page_size) — ダッシュボード一覧・検索
• get_dashboard(identifier) — ダッシュボード詳細（id または slug）

設定（環境変数）

変数	必須	既定(プロセス)	用途
REDASH_URL	✅	—	例 http://redash。常にサーバサイド。
REDASH_API_KEY	stdioで必須	—	既定APIキー。HTTPはX-REDASH-API-KEYで上書き可。
REDASH_MCP_TRANSPORT		stdio	stdio / streamable-http。CLI --transport。
REDASH_MCP_HOST		127.0.0.1	http バインドホスト。CLI --host。
REDASH_MCP_PORT		8000	http ポート。CLI --port。
REDASH_MCP_ALLOWED_HOSTS		（なし）	許可 Host（カンマ区切り）。例 redash-mcp:*。
REDASH_TIMEOUT		30	HTTP タイムアウト秒
REDASH_POLL_TIMEOUT		60	ジョブ待機の上限秒
REDASH_MAX_ROWS		1000	返却行数の上限

実行

ローカル（uv）:

uv run redash-mcp                                             # stdio
uv run redash-mcp --transport streamable-http --host 127.0.0.1 --port 8000

Docker（既定で streamable-http / 0.0.0.0:8000）:

docker run --rm -p 8000:8000 \
  -e REDASH_URL=http://redash -e REDASH_API_KEY=xxxx redash-mcp

streamable-http でネットワーク公開する場合は DNS リバインディング対策として REDASH_MCP_ALLOWED_HOSTS を設定することを推奨。

LibreChat 連携

各ユーザーが自分の Redash API キーを持てる（X-REDASH-API-KEY ヘッダ）。 REDASH_URL はサーバ側で固定し、REDASH_API_KEY（サーバ既定キー）は設定しない。 各リクエストの X-REDASH-API-KEY ヘッダを実効キーとする。

1. LibreChat の mcpServers 設定

redash:
  type: "streamable-http"
  url: "http://redash-mcp:8000/mcp"
  headers:
    X-REDASH-API-KEY: "{{REDASH_API_KEY}}"
  customUserVars:
    REDASH_API_KEY:
      title: "Redash API Key"
      description: "Redash の [ユーザー設定] から発行した API キー"

2. docker-compose（LibreChat と同一ネットワークに接続）

コンテナは LibreChat と同じ Docker ネットワークに置き、REDASH_MCP_ALLOWED_HOSTS で許可 Host を絞る。ホストへのポート公開は不要（LibreChat から内部ネットワーク 経由で http://redash-mcp:8000/mcp に接続する）。

services:
  redash-mcp:
    image: redash-mcp
    build: .
    environment:
      REDASH_URL: http://redash
      REDASH_MCP_ALLOWED_HOSTS: "redash-mcp:*"
      # REDASH_API_KEY は設定しない（各ユーザーが X-REDASH-API-KEY ヘッダで供給）
    networks:
      - librechat_default

networks:
  librechat_default:
    external: true

スタンドアロン（LibreChat を使わない）構成は docker-compose.example.yml を参照。

開発

uv sync
uv run pytest