Servidor MCP de Teradata

Un servidor del Protocolo de Contexto de Modelo (MCP) para bases de datos Teradata con autenticación OAuth 2.1, múltiples mecanismos de autenticación (TD2, LDAP, Kerberos) y visualización de datos interactiva.

Características

• Múltiples mecanismos de autenticación — TD2 (predeterminado), LDAP, Kerberos, JWT mediante LOGMECH de Teradata

• OAuth 2.1 con integración de Keycloak, validación de JWT, autorización basada en ámbitos (scopes)

• Metadatos de recursos protegidos (conforme a RFC 9728)

• Visualización interactiva — Aplicación MCP basada en ECharts con 19 tipos de gráficos

• Resiliencia de conexión — reintento automático con retroceso exponencial

• E/S no bloqueante — todas las operaciones de BD se ejecutan mediante asyncio.to_thread()

• QueryBand por herramienta — registro de auditoría para la gestión de cargas de trabajo de Teradata

Herramientas

Herramientas de consulta

• query — Ejecutar consultas SQL, devolver resultados tabulares simples

• visualize_query — Ejecutar SQL y renderizar gráficos interactivos de ECharts mediante la aplicación MCP

Herramientas de esquema

• list_db — Listar todas las bases de datos

• list_tables — Listar tablas/vistas en una base de datos

• show_tables_details — Mostrar nombres de columnas y tipos para una tabla

Herramientas de análisis

• list_missing_values — Columnas con recuentos de valores NULL

• list_negative_values — Columnas con recuentos de valores negativos

• list_distinct_values — Recuentos de categorías distintas por columna

• standard_deviation — Media y desviación estándar para una columna

Aplicación MCP — Visualización interactiva

La herramienta visualize_query renderiza los resultados como gráficos interactivos en el cliente MCP.

Inicio rápido

Instalación

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

Ejecutar con TD2 (Autenticación estándar)

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

O mediante variable de entorno:

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

Configuración

Claude Desktop

Añadir a su claude_desktop_config.json:

TD2 (Nombre de usuario/Contraseña)

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

Autenticación LDAP

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

El formato authcid depende del directorio LDAP:

Autenticación Kerberos

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

Configuración habilitada para OAuth

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

Variables de entorno

Conexión a base de datos

Resiliencia de conexión

Transporte MCP

OAuth 2.1

Ámbitos de OAuth

Compatibilidad de transporte

Puntos finales de descubrimiento (cuando OAuth está habilitado):

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

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

• /health — Comprobación de estado

Despliegue en Docker

Desarrollo

docker compose up -d

Con OAuth

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

Construcción

uv build

Solución de problemas

Problemas de conexión a la base de datos:

• Verifique el formato de DATABASE_URI: teradatasql://user:pass@host/database

• Compruebe la conectividad de red con el servidor Teradata

• Para LDAP: asegúrese de que DB_LOGMECH=LDAP y DB_LOGDATA estén configurados correctamente

• Los problemas de conexión se reintentan automáticamente (configurable mediante DB_MAX_RETRIES)

La autenticación LDAP falla:

• Verifique que el servidor Teradata tenga LDAP configurado en TDGSS

• Compruebe que el formato authcid coincida con su tipo de directorio

• Escape los caracteres especiales en las contraseñas (@ → \@, espacios → use comillas)

Errores de permiso denegado:

• Verifique que el usuario tenga los ámbitos de OAuth requeridos

• Compruebe las asignaciones de roles de Keycloak

• visualize_query requiere el ámbito teradata:query (no solo teradata:read)

Registro de depuración:

export LOG_LEVEL=DEBUG
uv run teradata-mcp

Licencia

Licencia MIT. Consulte LICENSE para obtener más detalles.

Agradecimientos

• Model Context Protocol

• Keycloak

• Teradata

• FastMCP