{"id":29113756,"url":"https://github.com/teradata/teradata-mcp-server","last_synced_at":"2025-09-25T06:02:25.266Z","repository":{"id":288506253,"uuid":"968270446","full_name":"Teradata/teradata-mcp-server","owner":"Teradata","description":"The community development of a MCP server for a Teradata database","archived":false,"fork":false,"pushed_at":"2025-06-27T16:27:18.000Z","size":642,"stargazers_count":13,"open_issues_count":6,"forks_count":11,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-06-27T17:36:05.583Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Teradata.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-17T19:41:30.000Z","updated_at":"2025-06-27T16:27:22.000Z","dependencies_parsed_at":"2025-06-19T00:33:07.571Z","dependency_job_id":null,"html_url":"https://github.com/Teradata/teradata-mcp-server","commit_stats":null,"previous_names":["teradata/mcp-server","teradata/teradata-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Teradata/teradata-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Teradata%2Fteradata-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Teradata%2Fteradata-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Teradata%2Fteradata-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Teradata%2Fteradata-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Teradata","download_url":"https://codeload.github.com/Teradata/teradata-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Teradata%2Fteradata-mcp-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262581380,"owners_count":23331913,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-29T11:05:48.045Z","updated_at":"2025-09-25T06:02:25.258Z","avatar_url":"https://github.com/Teradata.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n  \u003c!-- Optional: replace with a logo if you have one --\u003e\n  \u003c!-- \u003cimg src=\"docs/media/logo.svg\" alt=\"Teradata MCP Server\" width=\"120\"\u003e --\u003e\n  \n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eTeradata MCP Server\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/Teradata/teradata-mcp-server/blob/main/docs/README.md\"\u003e\n    \u003cimg alt=\"docs\" src=\"https://img.shields.io/badge/docs-readme-555?logo=readthedocs\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/Teradata/teradata-mcp-server/releases\"\u003e\n    \u003cimg alt=\"release\" src=\"https://img.shields.io/github/v/release/Teradata/teradata-mcp-server?display_name=tag\u0026sort=semver\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/teradata-mcp-server/\"\u003e\n    \u003cimg alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/teradata-mcp-server\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/teradata-mcp-server/\"\u003e\n    \u003cimg alt=\"downloads\" src=\"https://img.shields.io/pypi/dm/teradata-mcp-server?label=downloads\u0026color=2ea44f\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Model Context Protocol (MCP) server for Teradata\n \u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  ✨ \u003ca href=\"https://github.com/Teradata/teradata-mcp-server?tab=readme-ov-file#quick-start-with-claude-desktop-no-installation\"\u003eQuickstart with Claude Desktop \u003c/a\u003e or \u003ca href=\"https://github.com/Teradata/teradata-mcp-server/blob/main/docs/README.md#-quick-start\"\u003e your favorite tool\u003c/a\u003e in \u003c5 minute ✨\n\u003c/p\u003e\n\n## Overview\nThe Teradata MCP server provides sets of tools and prompts, grouped as modules for interacting with Teradata databases. Enabling AI agents and users to query, analyze, and manage their data efficiently. \n\n![Getting Started](https://raw.githubusercontent.com/Teradata/teradata-mcp-server/main/docs/media/client-server-platform.png)\n\n## Key features\n\n### Available tools and prompts\n\nWe are providing groupings of tools and associated helpful prompts to support all type of agentic applications on the data platform.\n\n![Teradata MCP Server diagram](https://raw.githubusercontent.com/Teradata/teradata-mcp-server/main/docs/media/teradata-mcp-server.png)\n\n- **Search** tools, prompts and resources to search and manage vector stores.\n  - [RAG Tools](https://github.com/Teradata/teradata-mcp-server/blob/main/src/teradata_mcp_server/tools/rag/README.md) rapidly build RAG applications.\n- **Query** tools, prompts and resources to query and navigate your Teradata platform:\n  - [Base Tools](https://github.com/Teradata/teradata-mcp-server/blob/main/src/teradata_mcp_server/tools/base/README.md)\n- **Table** tools, to efficiently and predictably access structured data models:\n  - [Feature Store Tools](https://github.com/Teradata/teradata-mcp-server/blob/main/src/teradata_mcp_server/tools/fs/README.md) to access and manage the Teradata Enterprise Feature Store.\n  - [Semantic layer definitions](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/server_guide/CUSTOMIZING.md) to easily implement domain-specific tools, prompts and resources for your own business data models. \n- **Data Quality** tools, prompts and resources accelerate exploratory data analysis:\n  - [Data Quality Tools](https://github.com/Teradata/teradata-mcp-server/blob/main/src/teradata_mcp_server/tools/qlty/README.md)\n- **DBA** tools, prompts and resources to facilitate your platform administration tasks:\n  - [DBA Tools](https://github.com/Teradata/teradata-mcp-server/blob/main/src/teradata_mcp_server/tools/dba/README.md)\n  - [Security Tools](https://github.com/Teradata/teradata-mcp-server/blob/main/src/teradata_mcp_server/tools/sec/README.md)\n\n## Quick start with Claude Desktop (no installation)\n\u003e Prefer to use other tools? Check out our Quick Starts for [VS Code/Copilot](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/server_guide/QUICK_START_VSCODE.md), [Open WebUI](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/server_guide/QUICK_START_OPEN_WEBUI.md), or dive into [simple code examples](https://github.com/Teradata/teradata-mcp-server/blob/main/examples/README.md#client-applications)!\nYou can use Claude Desktop to give the  Teradata MCP server a quick try, Claude can manage the server in the background using `uv`. No permanent installation needed.\n\n**Pre-requisites**\n1. Get your Teradata database credentials or create a free sandbox at [Teradata Clearscape Experience](https://www.teradata.com/getting-started/demos/clearscape-analytics).\n2. Install [Claude Desktop](https://claude.ai/download).\n3. Install [uv](https://docs.astral.sh/uv/getting-started/installation/). If you are on MacOS, Use Homebrew: `brew install uv`.\n\nConfigure the claude_desktop_config.json (Settings\u003eDeveloper\u003eEdit Config) by adding the configuration below, updating the database username, password and URL:\n\n```json\n{\n  \"mcpServers\": {\n    \"teradata\": {\n      \"command\": \"uvx\",\n      \"args\": [\"teradata-mcp-server\"],\n      \"env\": {\n        \"DATABASE_URI\": \"teradata://\u003cUSERNAME\u003e:\u003cPASSWORD\u003e@\u003cHOST_URL\u003e:1025/\u003cUSERNAME\u003e\"\n      }\n    }\n  }\n}\n```\n\n## Setting up your environment\n\nFollow this process to install your server, connect it to your Teradata platform and integrated your tools.\n\n**Step 1.** - Identify the running Teradata System, you need username, password and host details. If you do not have a Teradata system to connect to, then leverage [Teradata Clearscape Experience](https://www.teradata.com/getting-started/demos/clearscape-analytics)\n\n**Step 2.** - To install, configure and run the MCP server, refer to the [Getting started guide](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/server_guide/GETTING_STARTED.md), or see below for a quick [CLI installation](#CLI-Installation). You can easily [customize the server with your own tools, prompts and resources](docs/server_guide/CUSTOMIZING.md).\n\n**Step 3.** - There are many client options available, the [Client Guide](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/README.md#-client-guide) explains how to configure and run a sample of different clients.\n\n\u003cbr\u003e\n\nCheck out our [documentation](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/README.md) and libraries of [curated examples](https://github.com/Teradata/teradata-mcp-server/blob/main/examples/) or [video guides](https://github.com/Teradata/teradata-mcp-server/blob/doc-v1.4/docs/server_guide/VIDEO_LIBRARY.md).\n\n\u003cbr\u003e\n\n## CLI Installation\n\nWe recommend `uv` or `pipx` to install teradata-mcp-server as a CLI tool on your system. \nThey provide isolated environments and ensure the `teradata-mcp-server` command is available system-wide without interfering with system Python.\n\n```bash\nuv tool install \"teradata-mcp-server\"\n```\n\nor with pipx\n\n```bash\npipx install \"teradata-mcp-server\"\n```\n\nTo install the optional Enterprise Feature Store (fs) and Enterprise Vector Store (evs) packages:\n```bash\nuv tool install \"teradata-mcp-server[fs,evs]\"\n```\n\nAlternatively, you may use pip in a virtual environment (Python\u003e=3.11):\n\n```bash\npip install teradata-mcp-server\n```\n\nFor usage:\n\n```bash\nteradata-mcp-server --help\n```\n\n\n## Build from Source (Development)\n\nFor development or customization, you can build from source:\n\n1. Install [uv](https://docs.astral.sh/uv/getting-started/installation/). If you are on macOS, use Homebrew: `brew install uv`\n2. Clone this repository: `git clone https://github.com/Teradata/teradata-mcp-server.git`\n3. Navigate to the directory: `cd teradata-mcp-server`\n4. Run the server: `uv run teradata-mcp-server`\n\nFor Claude Desktop with development build, use this configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"teradata\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"\u003cPATH_TO_DIRECTORY\u003e/teradata-mcp-server\",\n        \"run\",\n        \"teradata-mcp-server\"\n      ],\n      \"env\": {\n        \"DATABASE_URI\": \"teradata://\u003cUSERNAME\u003e:\u003cPASSWORD\u003e@\u003cHOST_URL\u003e:1025/\u003cUSERNAME\u003e\",\n        \"MCP_TRANSPORT\": \"stdio\"\n      }\n    }\n  }\n}\n```\n\n## Contributing\nPlease refer to the [Contributing](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/developer_guide/CONTRIBUTING.md) guide and the [Developer Guide](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/developer_guide/DEVELOPER_GUIDE.md).\n\n\n---------------------------------------------------------------------\n## Certification\n\u003ca href=\"https://glama.ai/mcp/servers/@Teradata/teradata-mcp-server\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@Teradata/teradata-mcp-server/badge\" alt=\"Teradata Server MCP server\" /\u003e\n\u003c/a\u003e\n","funding_links":[],"categories":["Databases"],"sub_categories":["How to Submit"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteradata%2Fteradata-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteradata%2Fteradata-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteradata%2Fteradata-mcp-server/lists"}