Metabase MCP Server

Сервер протокола контекста модели (MCP), который интегрирует ИИ-ассистентов с аналитической платформой Metabase.

Обзор

Этот MCP-сервер обеспечивает интеграцию с API Metabase, позволяя LLM с поддержкой MCP напрямую взаимодействовать с вашими аналитическими данными. Этот сервер выступает в качестве моста между вашей аналитической платформой и разговорным ИИ.

Основные возможности

• Доступ к ресурсам: Навигация по ресурсам Metabase с помощью интуитивно понятных URI metabase://

• Два метода аутентификации: Поддержка аутентификации как на основе сессий, так и с помощью API-ключей

• Структурированный доступ к данным: Ответы в формате JSON для удобного использования ИИ-ассистентами

• Комплексное логирование: Подробное логирование для упрощения отладки и мониторинга

• Обработка ошибок: Надежная обработка ошибок с понятными сообщениями

Related MCP server: Metabase MCP Server

Доступные инструменты

Сервер предоставляет следующие инструменты для ИИ-ассистентов:

Инструменты доступа к данным

• list_dashboards: Получение всех доступных дашбордов в вашем экземпляре Metabase

• list_cards: Получение всех сохраненных вопросов/карточек в Metabase

• list_databases: Просмотр всех подключенных источников баз данных

• list_collections: Список всех коллекций в Metabase

• list_tables: Список всех таблиц в конкретной базе данных

• get_table_fields: Получение всех полей/столбцов в конкретной таблице

Инструменты выполнения

• execute_card: Запуск сохраненных вопросов и получение результатов с дополнительными параметрами

• execute_query: Выполнение пользовательских SQL-запросов к любой подключенной базе данных

Управление дашбордами

• get_dashboard_cards: Извлечение всех карточек из конкретного дашборда

• create_dashboard: Создание нового дашборда с указанным именем и параметрами

• update_dashboard: Обновление имени, описания или параметров существующего дашборда

• delete_dashboard: Удаление дашборда

• add_card_to_dashboard: Добавление или обновление карточек на дашборде с указанием позиции и дополнительным назначением вкладки

Управление карточками/вопросами

• create_card: Создание нового вопроса/карточки с SQL-запросом

• update_card_visualization: Обновление настроек визуализации для карточки

Управление коллекциями

• create_collection: Создание новой коллекции для организации дашбордов и вопросов

Конфигурация

Сервер поддерживает два метода аутентификации:

Вариант 1: Аутентификация по имени пользователя и паролю

# Required
METABASE_URL=https://your-metabase-instance.com
METABASE_USER_EMAIL=your_email@example.com
METABASE_PASSWORD=your_password

# Optional
LOG_LEVEL=info # Options: debug, info, warn, error, fatal

Вариант 2: Аутентификация по API-ключу (рекомендуется для продакшена)

# Required
METABASE_URL=https://your-metabase-instance.com
METABASE_API_KEY=your_api_key

# Optional
LOG_LEVEL=info # Options: debug, info, warn, error, fatal

Вы можете задать эти переменные окружения напрямую или использовать файл .env с помощью dotenv.

Развертывание с помощью Smithery

Чтобы использовать этот MCP-сервер с Claude или другими ИИ-ассистентами, сделайте форк этого репозитория и разверните его с помощью Smithery:

Шаги для развертывания:

1. Сделайте форк этого репозитория в свой аккаунт GitHub

2. Перейдите на Smithery и подключитесь через свой аккаунт GitHub

3. Разверните форкнутый репозиторий через интерфейс Smithery

Интеграция с Claude Desktop

Настройте свой Claude Desktop для использования версии, размещенной на Smithery:

MacOS: Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: Отредактируйте %APPDATA%/Claude/claude_desktop_config.json

Аутентификация по API-ключу:

{
  "mcpServers": {
    "metabase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "YOUR_GITHUB_USERNAME/metabase-mcp-server",
        "--config",
        "{\"metabaseUrl\":\"https://your-metabase-instance.com\",\"metabaseApiKey\":\"your_api_key\",\"metabasePassword\":\"\",\"metabaseUserEmail\":\"\"}"
      ]
    }
  }
}

Аутентификация по имени пользователя и паролю:

{
  "mcpServers": {
    "metabase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "YOUR_GITHUB_USERNAME/metabase-mcp-server",
        "--config",
        "{\"metabaseUrl\":\"https://your-metabase-instance.com\",\"metabaseApiKey\":\"\",\"metabasePassword\":\"your_password\",\"metabaseUserEmail\":\"your_email@example.com\"}"
      ]
    }
  }
}

Вопросы безопасности

• Рекомендуется использовать аутентификацию по API-ключу для производственных сред

• Храните свои API-ключи и учетные данные в безопасности

• Рассмотрите возможность использования переменных окружения вместо жесткого кодирования учетных данных

• Применяйте соответствующие меры сетевой безопасности для ограничения доступа к вашему экземпляру Metabase

Вклад в проект

Мы приветствуем любой вклад! Пожалуйста, не стесняйтесь отправлять Pull Request.