Teradata MCP Docker Image

This repository contains the build configuration for the mintmcp/teradata image published on Docker Hub. The image vendors the upstream Teradata/teradata-mcp-server server as a git submodule and adds the packages required to run safely inside MintMCP's hosted environment.

Motivation

• MintMCP's orchestration layer relies on curl, nodejs, npm, Python 3, and uv, so we preinstall them to keep parity with the hosted runtime.
• Tracking the Teradata server source as a submodule lets us follow upstream tags for security fixes while keeping MintMCP-specific tooling in the container.

Testing the image locally

The published image targets MintMCP's infrastructure, but you can build and run it locally to sanity-check changes before publishing.

# Build a local image (matches the build-and-push script)
docker build \
  --platform linux/amd64 \
  -f Dockerfile \
  -t mintmcp/teradata:local \
  ./upstream

# Run the container with your Teradata credentials
docker run --rm \
  -p 8001:8001 \
  -e TD_HOST=<host> \
  -e TD_USER=<username> \
  -e TD_PASSWORD=<password> \
  mintmcp/teradata:local

Connect your MCP client to http://localhost:8001/mcp/ to verify server startup.

Building and publishing your own

We've provided tools to help you maintain your own fork of the image.

Build with Docker directly

git submodule update --init --recursive
git -C upstream fetch --tags
git -C upstream checkout v0.1.4  # or any tag you need

docker build \
  --platform linux/amd64 \
  -f Dockerfile \
  -t mintmcp/teradata:0.1.4 \
  ./upstream

Set the tag to the Teradata MCP release MintMCP will deploy (for example mintmcp/teradata:0.1.4) and check out the matching ref in the upstream/ submodule.

Build and push via helper script

docker login
./build-and-push.sh --version <tag> [--user <docker-user>] [--repo <docker-repo>]

Examples:

• ./build-and-push.sh --version latest
• ./build-and-push.sh --version 0.1.4
• ./build-and-push.sh --version main --user mydockeruser --repo teradata

The script:

1. Syncs the upstream submodule and checks out the requested ref (tag, branch, or commit).
2. Builds <docker-user>/<docker-repo>:<version> from that source using the repository Dockerfile.
3. Pushes the tagged image to Docker Hub and prints the resulting image digest for release notes.

Publishing checklist

1. Confirm the upstream Teradata/teradata-mcp-server ref you need is available.
2. Update the Dockerfile if additional MintMCP tooling is required.
3. Build and smoke-test the image locally (manual build or helper script).
4. Run docker login for the target registry if you have not already authenticated.
5. Run ./build-and-push.sh --version <tag> [--user <docker-user>] [--repo <docker-repo>] and record the reported digest for MintMCP release notes.

Contributing

Contributions are welcome! Please open an issue or pull request describing the change and any testing performed.

License

Licensed under the Apache License, Version 2.0. See the LICENSE file for details.