Overview
What is UFO MCP Server?
A server that enables controlling a Dynatrace UFO device through MCP-compatible clients like Claude Desktop. It supports multi-agent coordination via a Desktop Extension and offers tools to set lighting, play effects, and query state.
How to use UFO MCP Server?
Install via direct download, Docker, or build from source. Configure the UFO IP address via the --ufo-ip flag or UFO_IP environment variable. For single‑agent use, add a direct MCP configuration to your client (e.g., Claude Desktop or Cline). For multi‑agent coordination, build and install the Desktop Extension. Once configured, ask your client to perform actions like “turn the UFO red” or “play the rainbow effect.”
Key features of UFO MCP Server
- Control top ring, bottom ring, and logo independently.
- Play built-in effects such as rainbow, breathingGreen, and policeLights.
- Send raw API commands directly to the UFO.
- Stop effects and resume previous state from a stack.
- Query current LED state and list available effects.
- Supports stdio, HTTP/2, and legacy SSE transports simultaneously.
Use cases of UFO MCP Server
- Set entire UFO lighting to a single color (e.g., red).
- Start a perpetual animation (e.g., ocean wave) on the UFO.
- Independently color the top ring blue and bottom ring green.
- Adjust overall brightness of the UFO.
- Show the current UFO state to verify what is displayed.
FAQ from UFO MCP Server
What prerequisites do I need?
You need a Dynatrace UFO device on your network. Find its IP address (check your router or try ufo.local if mDNS is available).
How do I install the server?
Download the appropriate binary for your OS (macOS Apple Silicon, macOS Intel, or Linux) and make it executable. Alternatively, use Docker (docker pull starspace46/ufo-mcp:latest) or build from source with Go.
Can I use the server with multiple Claude Desktop instances?
Yes—use the Desktop Extension (build with make dxt and run the HTTP server). This allows multiple Claude instances to share the same UFO state and coordinate in real time.
What transport modes are supported?
The server supports stdio (for desktop clients like Claude and Cline), HTTP/2+SSE (for web-based clients), and legacy SSE (for MuleSoft Anypoint Code Builder).
How do I troubleshoot connection issues?
If the server cannot find the UFO, verify the IP address in your router’s admin panel. Ensure the UFO is powered on and connected to the same network. For effects not saving, check write permissions on the effects file location.
