Сервер Model Context Protocol для интеграции с Metabase.

Это MCP-сервер на базе TypeScript, реализующий интеграцию с Metabase API. Он позволяет ассистентам ИИ взаимодействовать с Metabase, предоставляя доступ к:

• Дашборды, вопросы/карточки и базы данных в качестве ресурсов
• Инструменты для перечисления и выполнения метабазовых запросов
• Возможность просматривать и взаимодействовать с данными метабазы

Особенности

Ресурсы

• Список и доступ к ресурсам метабазы через metabase:// URI
• Доступ к панелям, карточкам/вопросам и базам данных
• Тип контента JSON для доступа к структурированным данным

Инструменты

• list_dashboards - Список всех дашбордов в Metabase
• list_cards - Список всех вопросов/карт в Metabase
• list_databases - Перечислить все базы данных в Metabase
• execute_card - Выполните вопрос/карту Metabase и получите результаты
• get_dashboard_cards - Поставьте все карты на панель управления
• execute_query - Выполнение SQL-запроса к базе данных Metabase

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

Перед запуском сервера необходимо установить переменные среды для аутентификации. Сервер поддерживает два метода:

1. Ключ API (предпочтительно):

• METABASE_URL: URL вашего экземпляра Metabase (например, https://your-metabase-instance.com).

metabase-server MCP Server

A Model Context Protocol server for Metabase integration.

This is a TypeScript-based MCP server that implements integration with Metabase API. It allows AI assistants to interact with Metabase, providing access to:

• Dashboards, questions/cards, and databases as resources
• Tools for listing and executing Metabase queries
• Ability to view and interact with Metabase data

Features

Resources

• List and access Metabase resources via metabase:// URIs
• Access dashboards, cards/questions, and databases
• JSON content type for structured data access

Tools

• list_dashboards - List all dashboards in Metabase
• list_cards - List all questions/cards in Metabase
• list_databases - List all databases in Metabase
• execute_card - Execute a Metabase question/card and get results
• get_dashboard_cards - Get all cards in a dashboard
• execute_query - Execute a SQL query against a Metabase database

Configuration

Before running the server, you need to set environment variables for authentication. The server supports two methods:

1. API Key (Preferred):

   • METABASE_URL: The URL of your Metabase instance (e.g., https://your-metabase-instance.com).
   • METABASE_API_KEY: Your Metabase API key.

2. Username/Password (Fallback):

   • METABASE_URL: The URL of your Metabase instance.
   • METABASE_USERNAME: Your Metabase username.
   • METABASE_PASSWORD: Your Metabase password.

The server will first check for METABASE_API_KEY. If it’s set, API key authentication will be used. If METABASE_API_KEY is not set, the server will fall back to using METABASE_USERNAME and METABASE_PASSWORD. You must provide credentials for at least one of these methods.

Example setup:

Using API Key:

# Required environment variables
export METABASE_URL=https://your-metabase-instance.com
export METABASE_API_KEY=your_metabase_api_key

Or, using Username/Password:

# Required environment variables
export METABASE_URL=https://your-metabase-instance.com
export METABASE_USERNAME=your_username
export METABASE_PASSWORD=your_password

You can set these environment variables in your shell profile or use a .env file with a package like dotenv.

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

# Oneliner, suitable for CI environment
git clone https://github.com/imlewc/metabase-server.git && cd metabase-server && npm i && npm run build && npm link

To use with Claude Desktop, add the server config: