Каталог MCP
1luvc0d3/metabase-mcp

1luvc0d3/metabase-mcp

Name: 1luvc0d3/metabase-mcp
Availability: InStock
Author: 1luvc0d3

MCP сервер для Metabase с поддержкой записи, NLQ и AI-инсайтами. Создавайте дашборды, задавайте вопросы на русском языке, получайте тренды и аномалии. Полезен для команд на Metabase младше v0.60 или нуждающихся в write-доступе и безопасности.

Github NPM Сайт сервера

README

12 инструментов

Версии

Установить сервер

metabase-mcp

The headless, AI-augmented MCP server for Metabase — API-key auth that works for agents, CI, and VPN'd self-hosted instances, with AI insights, production security controls, and support for any Metabase version.

Why This One?

Metabase ships an official MCP server (v0.60+), and since v0.61/v0.62 it covers both read and write operations — creating and updating questions, dashboards, and collections, plus raw SQL execution. It's good, and if it fits your setup you should consider it.

This server exists for the setups it doesn't fit:

Headless / agent use. The official server's MCP endpoint is OAuth-only, which requires a browser flow and a reachable HTTPS instance. (Metabase's underlying Agent API does accept API keys — but that capability isn't exposed over MCP.) This server authenticates with a Metabase API key over MCP — it works in CI, in autonomous agents, and on self-hosted instances behind a VPN.
AI inside the server. NLQ-to-SQL, SQL explain/optimize/validate, automated insights, and trend analysis run in the server with your own Anthropic key — independent of which AI client connects.
Operational control. In Metabase's own words, their MCP server "doesn't come with granular control over which tools people can use" (docs) — it's an instance-wide on/off switch. This server has read/write/full modes, per-tool allow/deny lists, SQL injection guardrails, tiered rate limits, and risk-scored audit logging of every operation.
Composition. batch_execute (up to 20 parallel ops) and run_workflow (chained steps with output references) have no official equivalent.
Any Metabase version — including pre-v0.60 instances that can't use the official MCP at all.

Инструменты были проиндексированы: 18.10.2026

batch_executeтолько чтениевнешний мир

Выполняет несколько операций чтения за один вызов. Поддерживает до 20 операций, выполняемых параллельно. Поддерживаемые инструменты: get_dashboard, get_card, execute_card, get_database_schema, execute_query, search_content, list_dashboards, list_databases, list_cards.

Параметры

operationsobject[]обязательный
Массив операций для параллельного выполнения.

execute_cardтолько чтениеидемпотентныйвнешний мир

Выполнить существующий вопрос/карточку и получить результаты

Параметры

card_idnumberобязательный
ID карты для выполнения
fieldsstring[]
Названия столбцов, которые нужно включить в результаты (по умолчанию: все)
formatenum
Формат ответа (по умолчанию: compact). Используйте "default" для красиво отформатированного вывода.
limitnumber
Максимальное количество возвращаемых строк (по умолчанию: настройка maxRows на сервере)
offsetnumber
Смещение строк для пагинации
parametersobject
Необязательные параметры для параметризованных запросов.

execute_queryтолько чтениевнешний мир

Выполнить SQL-запрос (только операторы SELECT)

Параметры

database_idnumberобязательный
Идентификатор базы данных для запроса.
fieldsstring[]
Названия столбцов, которые нужно включить в результаты (по умолчанию: все)
formatenum
Формат ответа (по умолчанию: compact). Используйте "default" для красиво отформатированного вывода.
limitnumber
Максимальное количество возвращаемых строк (по умолчанию: настройка maxRows на сервере)
offsetnumber
Смещение строк для пагинации
sqlstringобязательный
SQL-запрос (только операторы SELECT)

get_cardтолько чтениеидемпотентныйвнешний мир

Получить подробности конкретного вопроса/карточки

Параметры

card_idnumberобязательный
Идентификатор карты

get_collectionsтолько чтениеидемпотентныйвнешний мир

Вывести список всех коллекций.

Параметры

Без параметров.

get_dashboardтолько чтениеидемпотентныйвнешний мир

Получить детали панели, включая её карточки.

Параметры

dashboard_idnumberобязательный
Идентификатор панели управления.

get_database_schemaтолько чтениеидемпотентныйвнешний мир

Получить таблицы и столбцы для базы данных

Параметры

database_idnumberобязательный
ID базы данных
detailenum
Уровень детализации. "tables_only" возвращает имена таблиц без столбцов.
formatenum
Формат ответа (по умолчанию: compact). Используйте "default" для красиво отформатированного вывода.
tablesstring[]
Фильтрует по конкретным названиям таблиц.

list_cardsтолько чтениеидемпотентныйвнешний мир

Выводит список вопросов/карточек в Metabase. Возвращает до 100 карточек. Используйте search_content для поиска.

Параметры

collection_idnumber
Фильтрует по идентификатору коллекции.
limitnumber
Максимальное количество возвращаемых карточек (по умолчанию 100)

list_dashboardsтолько чтениеидемпотентныйвнешний мир

Выведи список всех дашбордов в Metabase

Параметры

Без параметров.

list_databasesтолько чтениеидемпотентныйвнешний мир

Выведи список всех подключённых баз данных

Параметры

Без параметров.

run_workflowтолько чтениевнешний мир

Выполняет многоэтапный пайплайн рабочего процесса за один вызов. Шаги выполняются последовательно и могут ссылаться на результаты предыдущих шагов с помощью синтаксиса "$stepName.path". Пример: найти панели мониторинга, затем получить подробности первого результата, затем выполнить его карточки, всё за один вызов. Макс. 10 шагов.

Параметры

stepsobject[]обязательный
Упорядоченные шаги конвейера. Каждый шаг может ссылаться на результаты предыдущих шагов.

search_contentтолько чтениеидемпотентныйвнешний мир

Поиск по контенту Metabase (дашборды, карточки, коллекции)

Параметры

querystringобязательный
Поисковый запрос
typeenum
Фильтровать по типу контента.

`1.4.1`основная	12.07.2026
`1.4.0`	12.07.2026
`1.3.0`	21.04.2026
`1.2.0`	19.04.2026
`1.1.1`	12.04.2026
`1.1.0`	12.04.2026
`1.0.2`	12.04.2026
`1.0.0`	12.04.2026

Выберите клиент, чтобы установить 1luvc0d3/metabase-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "1luvc0d3-metabase-mcp-5hzad1lhbh": {
      "command": "npx",
      "args": [
        "@ai-1luvc0d3/metabase-mcp"
      ],
      "env": {
        "METABASE_URL": "https://your-metabase.example.com",
        "METABASE_API_KEY": "mb_your_api_key_here",
        "MCP_MODE": "read"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "1luvc0d3-metabase-mcp-5hzad1lhbh": {
      "command": "npx",
      "args": [
        "@ai-1luvc0d3/metabase-mcp"
      ],
      "env": {
        "METABASE_URL": "https://your-metabase.example.com",
        "METABASE_API_KEY": "mb_your_api_key_here",
        "MCP_MODE": "read"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "1luvc0d3-metabase-mcp-5hzad1lhbh": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@ai-1luvc0d3/metabase-mcp"
      ],
      "env": {
        "METABASE_URL": "https://your-metabase.example.com",
        "METABASE_API_KEY": "mb_your_api_key_here",
        "MCP_MODE": "read"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"1luvc0d3-metabase-mcp-5hzad1lhbh\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"@ai-1luvc0d3/metabase-mcp\"],\"env\":{\"METABASE_URL\":\"https://your-metabase.example.com\",\"METABASE_API_KEY\":\"mb_your_api_key_here\",\"MCP_MODE\":\"read\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "1luvc0d3-metabase-mcp-5hzad1lhbh": {
      "command": "npx",
      "args": [
        "@ai-1luvc0d3/metabase-mcp"
      ],
      "env": {
        "METABASE_URL": "https://your-metabase.example.com",
        "METABASE_API_KEY": "mb_your_api_key_here",
        "MCP_MODE": "read"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add 1luvc0d3-metabase-mcp-5hzad1lhbh --env METABASE_URL=https://your-metabase.example.com --env METABASE_API_KEY=mb_your_api_key_here --env MCP_MODE=read -- npx @ai-1luvc0d3/metabase-mcp

Либо через JSON-конфиг:

claude mcp add-json 1luvc0d3-metabase-mcp-5hzad1lhbh "{\"command\":\"npx\",\"args\":[\"@ai-1luvc0d3/metabase-mcp\"],\"env\":{\"METABASE_URL\":\"https://your-metabase.example.com\",\"METABASE_API_KEY\":\"mb_your_api_key_here\",\"MCP_MODE\":\"read\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add 1luvc0d3-metabase-mcp-5hzad1lhbh --env METABASE_URL=https://your-metabase.example.com --env METABASE_API_KEY=mb_your_api_key_here --env MCP_MODE=read -- npx @ai-1luvc0d3/metabase-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.1luvc0d3-metabase-mcp-5hzad1lhbh]
command = "npx"
args = ["@ai-1luvc0d3/metabase-mcp"]

[mcp_servers.1luvc0d3-metabase-mcp-5hzad1lhbh.env]
METABASE_URL = "https://your-metabase.example.com"
METABASE_API_KEY = "mb_your_api_key_here"
MCP_MODE = "read"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите 1luvc0d3/metabase-mcp, а в поле команды запуска — строку ниже:

npx @ai-1luvc0d3/metabase-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "1luvc0d3-metabase-mcp-5hzad1lhbh": {
      "command": "npx",
      "args": [
        "@ai-1luvc0d3/metabase-mcp"
      ],
      "env": {
        "METABASE_URL": "https://your-metabase.example.com",
        "METABASE_API_KEY": "mb_your_api_key_here",
        "MCP_MODE": "read"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "1luvc0d3-metabase-mcp-5hzad1lhbh": {
      "command": "npx",
      "args": [
        "@ai-1luvc0d3/metabase-mcp"
      ],
      "env": {
        "METABASE_URL": "https://your-metabase.example.com",
        "METABASE_API_KEY": "mb_your_api_key_here",
        "MCP_MODE": "read"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например 1luvc0d3-metabase-mcp-5hzad1lhbh.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: 1luvc0d3-metabase-mcp-5hzad1lhbh
    command: npx
    args:
      - "@ai-1luvc0d3/metabase-mcp"
    env:
      METABASE_URL: https://your-metabase.example.com
      METABASE_API_KEY: mb_your_api_key_here
      MCP_MODE: read

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "1luvc0d3-metabase-mcp-5hzad1lhbh": {
      "command": "npx",
      "args": [
        "@ai-1luvc0d3/metabase-mcp"
      ],
      "env": {
        "METABASE_URL": "https://your-metabase.example.com",
        "METABASE_API_KEY": "mb_your_api_key_here",
        "MCP_MODE": "read"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "@ai-1luvc0d3/metabase-mcp"
  ],
  "env": {
    "METABASE_URL": "https://your-metabase.example.com",
    "METABASE_API_KEY": "mb_your_api_key_here",
    "MCP_MODE": "read"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx