Teradata Database

v1.0.0Databasesstable

The community development of a MCP server for a Teradata database

teradatamcpai-integration
Share:
51
Stars
0
Downloads
0
Weekly
0/5

What is Teradata Database?

Teradata Database is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to community development of a mcp server for a teradata database

The community development of a MCP server for a Teradata database

This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • The community development of a MCP server for a Teradata dat

Use Cases

Query and manage Teradata databases through community-developed MCP server.
Teradata

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx teradata

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Teradata Database

The Teradata MCP Server connects AI agents like Claude directly to Teradata databases, enabling natural-language querying, data quality analysis, and administrative tasks without writing raw SQL. It organises capabilities into focused modules — Query, Search (RAG/vector), Table, Data Quality, DBA, and Data Scientist — so teams can use AI for everything from routine database navigation to ML model workflows. If you manage large-scale Teradata environments and want to ask questions in plain English rather than T-SQL, this server bridges that gap in under five minutes using the `uv` package manager.

Prerequisites

  • Python 3.10+ and the `uv` package manager (brew install uv on macOS, pip install uv elsewhere)
  • A running Teradata database instance with a valid hostname, username, and password
  • Network access from your machine to the Teradata host on port 1025
  • Claude Desktop (or another MCP-compatible client) installed and configured
  • Teradata credentials with sufficient privileges for the operations you want to perform
1

Install the uv package manager

The Teradata MCP Server is distributed as a Python package and uses `uv` for fast, isolated execution. Install it before anything else.

# macOS
brew install uv

# Windows / Linux
pip install uv
2

Test the server runs

Run the server once with `uvx` to confirm the package installs correctly. You should see it start and wait for a connection; press Ctrl+C to stop.

uvx teradata-mcp-server
3

Gather your DATABASE_URI connection string

The server uses a single `DATABASE_URI` environment variable to connect to Teradata. Build your URI from your credentials.

# Format
teradata://<USERNAME>:<PASSWORD>@<HOST_URL>:1025/<DATABASE>

# Example
teradata://myuser:[email protected]:1025/mydb
4

Add the server to Claude Desktop

Open Claude Desktop and navigate to Settings > Developer > Edit Config. Add the server block below, replacing the DATABASE_URI value with your actual connection string.

{
  "mcpServers": {
    "teradata": {
      "command": "uvx",
      "args": ["teradata-mcp-server"],
      "env": {
        "DATABASE_URI": "teradata://myuser:[email protected]:1025/mydb"
      }
    }
  }
}
5

Restart Claude Desktop and verify

Save the config file and fully quit and relaunch Claude Desktop. Open a new conversation — you should see the Teradata tools available in the tools panel.

6

Run your first query

Start a conversation in Claude and ask a natural-language question about your Teradata database to confirm everything works end-to-end.

Teradata Database Examples

Client configuration

Complete claude_desktop_config.json block for the Teradata MCP Server using uvx.

{
  "mcpServers": {
    "teradata": {
      "command": "uvx",
      "args": ["teradata-mcp-server"],
      "env": {
        "DATABASE_URI": "teradata://myuser:[email protected]:1025/mydb"
      }
    }
  }
}

Prompts to try

Example questions to ask Claude once the Teradata MCP Server is connected.

- "List all tables in the sales database and describe their schemas."
- "Run a data quality check on the customer_orders table and flag any nulls in required columns."
- "What are the top 10 products by revenue this quarter? Query the transactions table."
- "Show me the current DBA users and their roles on this Teradata system."
- "Create a vector store from the product_descriptions table so I can run semantic search on it."

Troubleshooting Teradata Database

Connection refused or timeout when the server starts

Double-check the host, port (1025), username, and password in your DATABASE_URI. Ensure your network allows outbound TCP to port 1025 on the Teradata host — firewalls often block this by default.

`uvx` command not found after installation

Ensure `uv` is installed correctly and its bin directory is on your PATH. Run `which uv` (macOS/Linux) or `where uv` (Windows) to confirm. If missing, reinstall via `pip install uv` or via Homebrew, then open a new terminal session.

Claude does not show Teradata tools after editing the config

Confirm the JSON in claude_desktop_config.json is valid (no trailing commas, properly quoted strings). Fully quit Claude Desktop (not just close the window) and relaunch. Check Claude's developer logs for startup errors.

Frequently Asked Questions about Teradata Database

What is Teradata Database?

Teradata Database is a Model Context Protocol (MCP) server that community development of a mcp server for a teradata database It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Teradata Database?

Follow the installation instructions on the Teradata Database GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Teradata Database?

Teradata Database works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Teradata Database free to use?

Yes, Teradata Database is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Databases MCP Servers

Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "teradata": { "command": "npx", "args": ["-y", "teradata"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Teradata Database?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides