# rustunifimcp

> rustunifimcp is an open-source MCP server for cloud and infrastructure. Rust MCP server for UniFi controllers with scoped tools and two-person change control. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, CLI, self-hosted
- **Website:** https://mechub.org/projects/rustunifimcp/
- **Repository:** https://github.com/mechubsec/rustunifimcp
- **MCP Registry name:** io.github.mechubsec/rustunifimcp
- **Categories:** cloud and infrastructure, security
- **Listing updated:** 2026-11-14

## About

This is the UniFi member of the mechub family of network-security MCP servers, and it is built on the shared mecmcp Rust foundation, so authentication, transport, audit, policy, inventory and change control come from that layer and only the UniFi resource model and tools live here. The README is candid that UniFi offers no candidate configuration, no staging and no commit, only immediate REST writes to live settings, which makes it the test of whether the shared change-control layer generalises.

The surface covers reads, workflows, operational actions and change control. Read tools include unifi_list_resources, unifi_get_resource, unifi_query_stats and unifi_search. It can run under two-person control, where changes need a second approval, over TLS, or in a lab mode. A PoE port power-cycle sits behind an explicit direct-commit flag.

It replaces an earlier Python server; of 33 legacy tools, 31 are covered and verified against a live controller. It needs UniFi Network Application 10.5.67 or UniFi OS Server 5.1.37 at minimum, ships as an OCI image and Linux amd64 tarball, and is labelled alpha. It is an independent project, not affiliated with Ubiquiti.

## Features

- **Curated UniFi tools:** Reads, workflows and operational actions over the controller API.
- **Two-person change control:** Changes require a second approval before they apply.
- **Lab mode:** A separate mode for lab guests without two-person approval.
- **Audited actions:** Audit and policy come from the shared mecmcp foundation.
- **Search and stats:** Query resources, statistics and search across the controller.
- **Container or tarball:** Run from an OCI image, Docker, a Proxmox LXC or a Linux amd64 release.

## Good for

- Let an agent inspect UniFi network resources read-only
- Require a second person to approve a configuration change
- Query controller statistics from a chat
- Replace an older Python UniFi MCP server
- Run network automation in a Proxmox LXC

## Install

### Claude Code (Terminal)

```sh
claude mcp add rustunifimcp -- docker run -i --rm ghcr.io/mechubsec/rustunifimcp:0.6.14
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rustunifimcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mechubsec/rustunifimcp:0.6.14"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "rustunifimcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mechubsec/rustunifimcp:0.6.14"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "rustunifimcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mechubsec/rustunifimcp:0.6.14"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "rustunifimcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mechubsec/rustunifimcp:0.6.14"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "rustunifimcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mechubsec/rustunifimcp:0.6.14"
      ]
    }
  }
}
```

## Tools

- `unifi_list_resources`: List controller resources.
- `unifi_get_resource`: Get one controller resource.
- `unifi_query_stats`: Query controller statistics.
- `unifi_search`: Search the controller.
- `unifi_device_action`: Run an operational action on a device, such as a PoE port power-cycle.

## FAQ

### Which UniFi versions are supported?

UniFi Network Application 10.5.67 or UniFi OS Server 5.1.37 at minimum.

### Is it affiliated with Ubiquiti?

No. The README says it is an independent community project.

### How mature is it?

It is described as alpha and in daily use on the maintainer's infrastructure, at v0.6.14.

### How is it deployed?

As an OCI image, with Docker, in a Proxmox LXC, or from a Linux amd64 release tarball.

### Is rustunifimcp free?

Yes. rustunifimcp is open source, so you can use and self-host it for free.

### How do I add rustunifimcp to Claude Code?

Run this command in your terminal: claude mcp add rustunifimcp -- docker run -i --rm ghcr.io/mechubsec/rustunifimcp:0.6.14

### What are the best alternatives to rustunifimcp?

The closest alternatives to rustunifimcp are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/rustunifimcp
