deployment_v2.md

Union v2 MCP deployment

This file contains instructions for deploying the Union v2 MCP server.

Setup

Clone the repo:

git clone https://github.com/unionai-oss/union-mcp

Install uv and the union-mcp package:

pip install uv

Running a local server

DISABLE_AUTH=1 uv run --with '.[v2]' mcp run examples/v2/server.py --transport sse

Deploy app to Union

Create a config file:

uv run --with union union create login --host <host>

Then export environment variables:

export FLYTE_ENDPOINT=dns:///demo.hosted.unionai.cloud
export FLYTE_ORG=demo  # use custom org name
export FLYTE_PROJECT=union-mcp  # use custom project name
export FLYTE_DOMAIN=development  # use custom domain name
export APP_PORT=8000  # use custom app port
export APP_NAME=union-mcp-v2  # use custom app name
export APP_SUBDOMAIN=mcp-v2  # use custom app subdomain

# for testing thea pp
export APP_NAME=union-mcp-v2-test  # use custom app name
export APP_SUBDOMAIN=union-mcp-v2-test  # use custom app subdomain

Create a Flyte v2 config file:

uv run --with '.[v2]' flyte create config --endpoint $FLYTE_ENDPOINT --project $FLYTE_PROJECT --domain $FLYTE_DOMAIN

Register dummy workflows for testing (optional):

uv run --with '.[v2]' flyte deploy --project $FLYTE_PROJECT --domain $FLYTE_DOMAIN examples/v2/workflows.py env

Register the build and run tasks:

uv run --with '.[v2]' flyte deploy --project $FLYTE_PROJECT --domain $FLYTE_DOMAIN app_v2_tasks.py

Then deploy the app:

uv run --with '.[v2]' flyte deploy --project $FLYTE_PROJECT --domain $FLYTE_DOMAIN app_v2.py app