Teradata MCP Server

Сервер протокола контекста модели (MCP) для базы данных Teradata с аутентификацией OAuth 2.1, поддержкой различных механизмов аутентификации (TD2, LDAP, Kerberos) и интерактивной визуализацией данных.

Возможности

• Множество механизмов аутентификации — TD2 (по умолчанию), LDAP, Kerberos, JWT через Teradata LOGMECH

• OAuth 2.1 с интеграцией Keycloak, проверкой JWT, авторизацией на основе областей (scopes)

• Метаданные защищенных ресурсов (соответствие RFC 9728)

• Интерактивная визуализация — приложение MCP на базе ECharts с 19 типами диаграмм

• Устойчивость соединений — автоматический повтор попыток с экспоненциальной задержкой

• Неблокирующий ввод-вывод — все операции с БД выполняются через asyncio.to_thread()

• QueryBand для каждого инструмента — журнал аудита для управления рабочей нагрузкой Teradata

Инструменты

Инструменты запросов

• query — выполнение SQL-запросов, возврат результатов в виде таблицы

• visualize_query — выполнение SQL и отрисовка интерактивных диаграмм ECharts через приложение MCP

Инструменты схемы

• list_db — список всех баз данных

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

• show_tables_details — отображение имен столбцов и типов данных для таблицы

Инструменты анализа

• list_missing_values — столбцы с количеством значений NULL

• list_negative_values — столбцы с количеством отрицательных значений

• list_distinct_values — количество уникальных категорий для каждого столбца

• standard_deviation — среднее значение и стандартное отклонение для столбца

Приложение MCP — Интерактивная визуализация

Инструмент visualize_query отображает результаты в виде интерактивных диаграмм в клиенте MCP.

Быстрый старт

Установка

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

Запуск с TD2 (Стандартная аутентификация)

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

Или через переменную окружения:

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

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

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

TD2 (Имя пользователя/Пароль)

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

Аутентификация 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"
      }
    }
  }
}

Формат authcid зависит от каталога LDAP:

Аутентификация Kerberos

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

Конфигурация с поддержкой 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"
      }
    }
  }
}

Переменные окружения

Подключение к базе данных

Устойчивость соединений

Транспорт MCP

OAuth 2.1

Области OAuth (Scopes)

Совместимость транспорта

Конечные точки обнаружения (при включенном OAuth):

• /.well-known/oauth-protected-resource — метаданные RFC 9728

• /.well-known/mcp-server-info — возможности MCP

• /health — проверка работоспособности

Развертывание в Docker

Разработка

docker compose up -d

С OAuth

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

Сборка

uv build

Устранение неполадок

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

• Проверьте формат DATABASE_URI: teradatasql://user:pass@host/database

• Проверьте сетевое подключение к серверу Teradata

• Для LDAP: убедитесь, что DB_LOGMECH=LDAP и DB_LOGDATA установлены правильно

• Проблемы с подключением автоматически повторяются (настраивается через DB_MAX_RETRIES)

Ошибка аутентификации LDAP:

• Убедитесь, что на сервере Teradata настроен LDAP в TDGSS

• Проверьте, что формат authcid соответствует типу вашего каталога

• Экранируйте специальные символы в паролях (@ → \@, пробелы → используйте кавычки)

Ошибки отказа в доступе (Permission denied):

• Убедитесь, что у пользователя есть необходимые области OAuth

• Проверьте назначение ролей в Keycloak

• visualize_query требует область teradata:query (а не только teradata:read)

Отладочное логирование:

export LOG_LEVEL=DEBUG
uv run teradata-mcp

Лицензия

Лицензия MIT. Подробности см. в файле LICENSE.

Благодарности

• Model Context Protocol

• Keycloak

• Teradata

• FastMCP