An open API service indexing awesome lists of open source software.

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


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

Last synced: 8 days ago
JSON representation

Awesome Lists containing this project

README

        

# Union MCP

An MCP server to use Union tasks, workflows, and apps as tools.

## Setup

Clone the repo:

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

Install `uv` and the `union-mcp` package:

```bash
pip install uv
uv sync
```

## Use with Claude Desktop

First, install [Claude Desktop](https://claude.ai/download).

Then, install the server

```
mcp install -e . examples/server.py
```

This will configure the `claude_desktop_config.json` configuration file located in:

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

You should see something like

```json
{
"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"
]
}
}
}
```

> [!NOTE]
> Make sure the `uv` executable is available in `/usr/local/bin`, otherwise
> replace `command` with the full path, e.g. `/Users/username/.local/bin/uv`

## Running a local server

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

```bash
mcp run examples/server.py --transport sse
```

```bash
npx @modelcontextprotocol/inspector
```