proxmox/mcp-site-manager

Site Manager MCP Server

Model Context Protocol (MCP) server for Ubiquiti UniFi Site Manager Cloud API management.

Features

• MCP integration for AI assistants (Claude Desktop, etc.)
• Access to Site Manager Cloud API endpoints
• Tools for managing hosts, sites, devices, metrics, and SD-WAN configurations
• Type-safe API interactions

Installation

pnpm install
pnpm build

Configuration

Create a ~/.env file with:

SITE_MANAGER_API_KEY=your-api-key-here
SITE_MANAGER_BASE_URL=https://api.ui.com/v1  # Optional

Usage

Starting the Server

pnpm start

Development Mode

pnpm dev

Available Tools

The server provides the following MCP tools:

• site_manager_list_hosts - List all hosts
• site_manager_list_sites - List all sites
• site_manager_list_devices - List all devices
• site_manager_get_isp_metrics - Get ISP metrics
• site_manager_list_sdwan_configs - List SD-WAN configurations
• site_manager_get_sdwan_config - Get SD-WAN configuration by ID
• site_manager_get_sdwan_config_status - Get SD-WAN configuration status by ID

Claude Desktop Integration

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "site-manager": {
      "command": "node",
      "args": [
        "/path/to/proxmox/mcp-site-manager/dist/index.js"
      ],
      "env": {
        "SITE_MANAGER_API_KEY": "your-api-key-here"
      }
    }
  }
}

Or use environment variables from ~/.env:

{
  "mcpServers": {
    "site-manager": {
      "command": "node",
      "args": [
        "/path/to/proxmox/mcp-site-manager/dist/index.js"
      ]
    }
  }
}

Getting an API Key

1. Sign in to the UniFi Site Manager at unifi.ui.com
2. Navigate to the API section from the left navigation bar
3. Select "Create API Key"
4. Copy the generated key and store it securely

Documentation

• Site Manager API Library
• Official Site Manager API Documentation

License

MIT