Teradata MCP-Server

Ein Model Context Protocol (MCP)-Server für Teradata-Datenbanken mit OAuth 2.1-Authentifizierung, mehreren Authentifizierungsmechanismen (TD2, LDAP, Kerberos) und interaktiver Datenvisualisierung.

Funktionen

• Mehrere Authentifizierungsmechanismen — TD2 (Standard), LDAP, Kerberos, JWT über Teradata LOGMECH

• OAuth 2.1 mit Keycloak-Integration, JWT-Validierung, bereichsbasierter Autorisierung

• Metadaten für geschützte Ressourcen (RFC 9728-konform)

• Interaktive Visualisierung — ECharts-basierte MCP-App mit 19 Diagrammtypen

• Verbindungsstabilität — automatische Wiederholung mit exponentiellem Backoff

• Nicht-blockierende E/A — alle Datenbankoperationen laufen über asyncio.to_thread()

• Tool-spezifisches QueryBand — Audit-Trail für Teradata-Workload-Management

Tools

Abfrage-Tools

• query — SQL-Abfragen ausführen, einfache tabellarische Ergebnisse zurückgeben

• visualize_query — SQL ausführen und interaktive ECharts-Diagramme über die MCP-App rendern

Schema-Tools

• list_db — Alle Datenbanken auflisten

• list_tables — Tabellen/Ansichten in einer Datenbank auflisten

• show_tables_details — Spaltennamen und -typen für eine Tabelle anzeigen

Analyse-Tools

• list_missing_values — Spalten mit NULL-Wert-Anzahl

• list_negative_values — Spalten mit negativer Wert-Anzahl

• list_distinct_values — Anzahl der unterschiedlichen Kategorien pro Spalte

• standard_deviation — Mittelwert und Standardabweichung für eine Spalte

MCP-App — Interaktive Visualisierung

Das Tool visualize_query rendert Ergebnisse als interaktive Diagramme im MCP-Client.

Schnellstart

Installation

git clone https://github.com/arturborycki/mcp-teradata.git
cd mcp-teradata
uv sync

Ausführung mit TD2 (Standard-Authentifizierung)

uv run teradata-mcp "teradatasql://user:password@host/database"

Oder über Umgebungsvariable:

export DATABASE_URI="teradatasql://user:password@host/database"
uv run teradata-mcp

Konfiguration

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

TD2 (Benutzername/Passwort)

{
  "mcpServers": {
    "teradata": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/mcp-teradata",
        "run", "teradata-mcp"
      ],
      "env": {
        "DATABASE_URI": "teradatasql://user:password@host/database"
      }
    }
  }
}

LDAP-Authentifizierung

{
  "mcpServers": {
    "teradata": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/mcp-teradata",
        "run", "teradata-mcp"
      ],
      "env": {
        "DATABASE_URI": "teradatasql://@host/database",
        "DB_LOGMECH": "LDAP",
        "DB_LOGDATA": "authcid=ldap_user password=ldap_password"
      }
    }
  }
}

Das authcid-Format hängt vom LDAP-Verzeichnis ab:

Kerberos-Authentifizierung

{
  "mcpServers": {
    "teradata": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/mcp-teradata",
        "run", "teradata-mcp"
      ],
      "env": {
        "DATABASE_URI": "teradatasql://@host/database",
        "DB_LOGMECH": "KRB5"
      }
    }
  }
}

OAuth-aktivierte Konfiguration

{
  "mcpServers": {
    "teradata": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/mcp-teradata",
        "run", "teradata-mcp"
      ],
      "env": {
        "DATABASE_URI": "teradatasql://user:password@host/database",
        "OAUTH_ENABLED": "true",
        "KEYCLOAK_URL": "https://your-keycloak.example.com",
        "KEYCLOAK_REALM": "teradata-realm",
        "KEYCLOAK_CLIENT_ID": "teradata-mcp",
        "KEYCLOAK_CLIENT_SECRET": "your-secret",
        "OAUTH_RESOURCE_SERVER_URL": "https://your-mcp-server.example.com"
      }
    }
  }
}

Umgebungsvariablen

Datenbankverbindung

Verbindungsstabilität

MCP-Transport

OAuth 2.1

OAuth-Scopes

Transport-Kompatibilität

Discovery-Endpunkte (wenn OAuth aktiviert ist):

• /.well-known/oauth-protected-resource — RFC 9728-Metadaten

• /.well-known/mcp-server-info — MCP-Funktionen

• /health — Gesundheitsprüfung

Docker-Bereitstellung

Entwicklung

docker compose up -d

Mit OAuth

docker compose -f docker-compose.oauth.yml up -d

Build

uv build

Fehlerbehebung

Probleme bei der Datenbankverbindung:

• Überprüfen Sie das DATABASE_URI-Format: teradatasql://user:pass@host/database

• Überprüfen Sie die Netzwerkkonnektivität zum Teradata-Server

• Für LDAP: Stellen Sie sicher, dass DB_LOGMECH=LDAP und DB_LOGDATA korrekt gesetzt sind

• Verbindungsprobleme werden automatisch wiederholt (konfigurierbar über DB_MAX_RETRIES)

LDAP-Authentifizierung schlägt fehl:

• Überprüfen Sie, ob der Teradata-Server LDAP in TDGSS konfiguriert hat

• Überprüfen Sie, ob das authcid-Format mit Ihrem Verzeichnistyp übereinstimmt

• Maskieren Sie Sonderzeichen in Passwörtern (@ → \@, Leerzeichen → Anführungszeichen verwenden)

Zugriffsverweigerungsfehler:

• Überprüfen Sie, ob der Benutzer über die erforderlichen OAuth-Scopes verfügt

• Überprüfen Sie die Keycloak-Rollenzuweisungen

• visualize_query erfordert den Scope teradata:query (nicht nur teradata:read)

Debug-Protokollierung:

export LOG_LEVEL=DEBUG
uv run teradata-mcp

Lizenz

MIT-Lizenz. Siehe LICENSE für Details.

Danksagungen

• Model Context Protocol

• Keycloak

• Teradata

• FastMCP