Union

🚀 Federal MCP Server

An MCP server for using Union tasks, workflows, and applications as tools.

🚀 Quick Start

📦 Installation

1. Clone the repository:

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

2. Install the uv and union-mcp packages:

pip install uv
uv sync

💻 Usage Examples

Use in combination with Claude Desktop

First, install Claude Desktop. Then, install the server:

mcp install -e . examples/server.py

This will configure the claude_desktop_config.json configuration file located at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json You should see something like this:

{
  "mcpServers": {
    "Union MCP": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with-editable",
        "/Users/username/union-mcp",
        "mcp",
        "run",
        "/Users/username/union-mcp/examples/server.py"
      ]
    }
  }
}

⚠️ Important Note

Make sure there is a uv executable in /usr/local/bin, otherwise replace it with the full path, such as /Users/username/.local/bin/uv

Run the local server

union register --project mcp-testing examples/workflows.py

mcp run examples/server.py --transport sse

npx @modelcontextprotocol/inspector