MCP Teradata

Teradata MCP服务器

用于Teradata数据库的模型上下文协议（MCP）服务器，具有OAuth 2.1身份验证、多种身份验证机制（TD2、LDAP、Kerberos）和交互式数据可视化。

特性

• 多种身份验证机制 --TD2（默认）、LDAP、Kerberos、通过Teradata的JWT LOGMECH
• OAuth 2.1 通过Keycloak集成、JWT验证、基于范围的授权
• 受保护资源元数据 （符合RFC 9728）
• 交互式可视化 --基于ECharts的MCP应用程序，有19种图表类型
• 连接弹性 --指数回退自动重试
• 非阻塞I/O --所有数据库操作都通过以下方式运行 asyncio.to_thread()
• 按工具QueryBand --Teradata工作负载管理的审计跟踪

工具

查询工具

• query --执行SQL查询，返回纯表格结果
• visualize_query --通过MCP应用程序执行SQL并呈现交互式ECharts图表

架构工具

• 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_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 授权范围

运输兼容性

发现端点（启用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服务器是否在TDGSS中配置了LDAP
• 检查 authcid 格式与您的目录类型匹配
• 转义密码中的特殊字符(@ → \@，空格→ 使用引号）

权限被拒绝错误：

• 验证用户是否具有所需的OAuth作用域
• 检查Keycloak角色分配
• visualize_query 需要 teradata:query 范围（不仅 teradata:read)

调试日志记录：

export LOG_LEVEL=DEBUG
uv run teradata-mcp

许可证

MIT许可证。看 许可证 了解详情。

致谢

• 模型上下文协议
• 钥匙锁
• 特拉达
• FastMCP