ufo

This UFO MCP server lets you control a Dynatrace UFO device via MCP-compatible clients (such as Claude Desktop or other MCP-enabled tools). The server exposes a set of built-in lighting controls, effects, and utility commands that let you configure lighting across the UFO's rings, trigger pre-defined effects, and query or modify the current state. You can run the server in multiple transport modes simultaneously (stdio for desktop clients, http for web-based clients, and legacy SSE for MuleSoft compatibility) and you can connect through a simple MCP configuration in Claude Desktop, Cline, or other MCP clients.

To use it, first ensure your UFO is reachable on the network (IP address or hostname). Then start the MCP server with the appropriate transport (stdio for local desktop clients is common) and provide the UFO IP. From there, you can issue commands like turning LEDs red, playing a predefined effect such as rainbow, or querying the current LED state. The server also ships a library of built-in effects and several tools that let you programmatically set lighting, play effects, and manage state stacks for smooth transitions across actions.

Prerequisites:

• A Dynatrace UFO device on the target network
• A host to run the UFO MCP server

Option 1: Direct Download (Recommended)

# macOS (Apple Silicon)
curl -L https://github.com/starspace46/ufo/releases/download/v1.0.1/ufo-mcp-darwin-arm64 -o /usr/local/bin/ufo-mcp
chmod +x /usr/local/bin/ufo-mcp

# macOS (Intel)
curl -L https://github.com/starspace46/ufo/releases/download/v1.0.1/ufo-mcp-darwin-amd64 -o /usr/local/bin/ufo-mcp
chmod +x /usr/local/bin/ufo-mcp

# Linux
curl -L https://github.com/starspace46/ufo/releases/download/v1.0.1/ufo-mcp-linux-amd64 -o /usr/local/bin/ufo-mcp
chmod +x /usr/local/bin/ufo-mcp

Option 2: Docker

docker pull starspace46/ufo-mcp:latest

# Run with Docker
docker run -d \
  --name ufo-mcp \
  -e UFO_IP=YOUR_UFO_IP_HERE \
  -v ~/.ufo-effects:/data \
  starspace46/ufo-mcp:latest

Option 3: Build from Source

git clone https://github.com/starspace46/ufo-mcp-server.git
cd ufo-mcp-server
# If Go is available
go build -o ufo-mcp ./cmd/server
sudo mv ufo-mcp /usr/local/bin/

Prerequisites recap:

• Go toolchain for building from source (if you choose Option 3)
• Network access to the UFO device
• Optional: Docker if you prefer containerized deployment

Tips and common considerations:

• You can provide the UFO IP using the --ufo-ip argument or via the UFO_IP environment variable.
• When using Docker, mount your local data directory (for effects) to /data as shown in the examples.
• The server supports multiple transport modes simultaneously; use --transport http for web clients and --transportstdio for desktop clients as needed.
• If you encounter issues finding the UFO, verify IP address or hostname resolution (ufo.local via mDNS can help).
• For persistent LED configurations across actions, leverage the available tools like getLedState, listEffects, and the effect stack management across stopEffect and playEffect.
• Ensure you grant execute permissions to the binary when installing directly. If using Docker, ensure the UFO_IP is reachable from the host.