Metabase MCP-Server

Ein Model Context Protocol-Server, der KI-Assistenten in die Metabase-Analyseplattform integriert.

Übersicht

Dieser MCP-Server bietet eine Integration mit der Metabase-API und ermöglicht es LLMs mit MCP-Funktionen, direkt mit Ihren Analysedaten zu interagieren. Dieser Server fungiert als Brücke zwischen Ihrer Analyseplattform und konversationsbasierter KI.

Hauptfunktionen

• Ressourcenzugriff: Navigieren Sie durch Metabase-Ressourcen über intuitive metabase://-URIs

• Zwei Authentifizierungsmethoden: Unterstützung für sitzungsbasierte Authentifizierung und API-Schlüssel-Authentifizierung

• Strukturierter Datenzugriff: JSON-formatierte Antworten für eine einfache Verarbeitung durch KI-Assistenten

• Umfassende Protokollierung: Detaillierte Protokolle für einfaches Debugging und Monitoring

• Fehlerbehandlung: Robuste Fehlerbehandlung mit klaren Fehlermeldungen

Related MCP server: Metabase MCP Server

Verfügbare Tools

Der Server stellt die folgenden Tools für KI-Assistenten bereit:

Datenzugriffs-Tools

• list_dashboards: Alle verfügbaren Dashboards in Ihrer Metabase-Instanz abrufen

• list_cards: Alle gespeicherten Fragen/Karten in Metabase abrufen

• list_databases: Alle verbundenen Datenbankquellen anzeigen

• list_collections: Alle Sammlungen in Metabase auflisten

• list_tables: Alle Tabellen in einer bestimmten Datenbank auflisten

• get_table_fields: Alle Felder/Spalten in einer bestimmten Tabelle abrufen

Ausführungs-Tools

• execute_card: Gespeicherte Fragen ausführen und Ergebnisse mit optionalen Parametern abrufen

• execute_query: Benutzerdefinierte SQL-Abfragen gegen jede verbundene Datenbank ausführen

Dashboard-Verwaltung

• get_dashboard_cards: Alle Karten aus einem bestimmten Dashboard extrahieren

• create_dashboard: Ein neues Dashboard mit angegebenem Namen und Parametern erstellen

• update_dashboard: Name, Beschreibung oder Parameter eines bestehenden Dashboards aktualisieren

• delete_dashboard: Ein Dashboard löschen

• add_card_to_dashboard: Karten mit Positionsangaben und optionaler Tab-Zuweisung zu einem Dashboard hinzufügen oder aktualisieren

Karten-/Fragen-Verwaltung

• create_card: Eine neue Frage/Karte mit SQL-Abfrage erstellen

• update_card_visualization: Visualisierungseinstellungen für eine Karte aktualisieren

Sammlungs-Verwaltung

• create_collection: Eine neue Sammlung erstellen, um Dashboards und Fragen zu organisieren

Konfiguration

Der Server unterstützt zwei Authentifizierungsmethoden:

Option 1: Benutzername- und Passwort-Authentifizierung

# 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

Option 2: API-Schlüssel-Authentifizierung (Empfohlen für die Produktion)

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

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

Sie können diese Umgebungsvariablen direkt festlegen oder eine .env-Datei mit dotenv verwenden.

Bereitstellung mit Smithery

Um diesen MCP-Server mit Claude oder anderen KI-Assistenten zu verwenden, forken Sie dieses Repository und stellen Sie es mit Smithery bereit:

Schritte zur Bereitstellung:

1. Forken Sie dieses Repository in Ihr GitHub-Konto

2. Gehen Sie zu Smithery und verbinden Sie sich mit Ihrem GitHub-Konto

3. Stellen Sie das geforkte Repository über die Benutzeroberfläche von Smithery bereit

Claude Desktop-Integration

Konfigurieren Sie Ihren Claude Desktop für die Verwendung der von Smithery gehosteten Version:

MacOS: Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: Bearbeiten Sie %APPDATA%/Claude/claude_desktop_config.json

API-Schlüssel-Authentifizierung:

{
  "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\":\"\"}"
      ]
    }
  }
}

Benutzername- und Passwort-Authentifizierung:

{
  "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\"}"
      ]
    }
  }
}

Sicherheitshinweise

• Es wird empfohlen, die API-Schlüssel-Authentifizierung für Produktionsumgebungen zu verwenden

• Bewahren Sie Ihre API-Schlüssel und Anmeldedaten sicher auf

• Erwägen Sie die Verwendung von Umgebungsvariablen anstelle von fest codierten Anmeldedaten

• Wenden Sie geeignete Netzwerksicherheitsmaßnahmen an, um den Zugriff auf Ihre Metabase-Instanz einzuschränken

Mitwirken

Beiträge sind willkommen! Bitte zögern Sie nicht, einen Pull Request einzureichen.