defined-mcp

MCP-Server für die Defined Networking API.

Installation

uv tool install git+https://github.com/quickvm/defined-mcp.git

Um eine bestimmte Version oder einen Branch zu installieren:

uv tool install git+https://github.com/quickvm/defined-mcp.git@main

Für die lokale Entwicklung:

git clone git@github.com:quickvm/defined-mcp.git
cd defined-mcp
uv tool install --editable .

Related MCP server: UniFi MCP Server

Konfiguration

Setzen Sie die Umgebungsvariable DEFINED_API_KEY auf Ihren Defined Networking API-Schlüssel. Sie erhalten diesen über Ihr Admin-Panel.

export DEFINED_API_KEY=dnkey-...

Verwendung

Zu Claude Code hinzufügen

claude mcp add defined_mcp -- defined-mcp serve

Starten Sie anschließend Claude Code neu.

Konnektivität überprüfen

defined-mcp check

Standalone ausführen

defined-mcp serve

Verfügbare Tools

Hosts

• list_hosts — Hosts mit Filtern auflisten (Rolle, blockiert, Lighthouse, Relay)

• get_host — Host-Details abrufen

• create_host — Einen Host/Lighthouse/Relay erstellen

• update_host — Einen Host aktualisieren (vollständiger Ersatz)

• delete_host — Einen Host löschen

• block_host / unblock_host — Einen Host blockieren/freigeben

• add_host_tag / remove_host_tag — Ein Tag zu einem Host hinzufügen/entfernen

• create_enrollment_code — Registrierungscode generieren

• create_host_and_enrollment_code — Host + Registrierungscode erstellen

Rollen & Firewall-Regeln

• list_roles / get_role — Rollen mit Firewall-Regeln auflisten/abrufen

• create_role / update_role — Rollen erstellen/aktualisieren (vollständiger Ersatz)

• delete_role — Eine Rolle löschen

• add_firewall_rule — Eine Firewall-Regel zu einer Rolle hinzufügen (flache Parameter, kein JSON)

• remove_firewall_rule — Eine Firewall-Regel nach Index entfernen

Tags

• list_tags / get_tag — Tags auflisten/abrufen

• create_tag / update_tag — Tags mit Konfigurations-Overrides erstellen/aktualisieren

• delete_tag — Ein Tag löschen

• add_tag_config_override — Ein Konfigurations-Override zu einem Tag hinzufügen/ersetzen

• remove_tag_config_override — Ein Konfigurations-Override nach Schlüssel entfernen

Netzwerke

• list_networks / get_network — Netzwerke auflisten/abrufen

• create_network / update_network — Netzwerke erstellen/aktualisieren

Routen

• list_routes / get_route — Routen mit Firewall-Regeln auflisten/abrufen

• create_route / update_route — Routen erstellen/aktualisieren (vollständiger Ersatz)

• delete_route — Eine Route löschen

• add_route_firewall_rule — Eine Firewall-Regel zu einer Route hinzufügen

• remove_route_firewall_rule — Eine Routen-Firewall-Regel nach Index entfernen

Sonstiges

• list_audit_logs — Audit-Log mit Filtern

• list_downloads — Software-Download-Links (nicht authentifiziert)

Claude Code Skills

Dieses Repository enthält einen Claude Code Skill für interaktives Netzwerkmanagement. Wenn Sie Claude Code aus diesem Repository ausführen, ist der Befehl /network-architect automatisch verfügbar.

Um den Skill in einem beliebigen Projekt zu verwenden, kopieren Sie ihn in Ihr Claude Code-Profil:

cp -r .claude/skills/network-architect ~/.claude/skills/

/network-architect audit

Führt ein Sicherheits- und Konfigurations-Audit Ihres Defined Networking-Kontos durch. Ruft alle Netzwerke, Rollen, Tags und Hosts ab und berichtet dann über:

• Rollen mit fehlenden oder zu freizügigen Firewall-Regeln

• Tote Tags (keine Hosts zugewiesen)

• Hosts ohne Tags, veraltete dnclient-Versionen oder veraltete "Zuletzt gesehen"-Zeitstempel

• Zusammenfassung der Firewall-Abdeckung pro Rolle mit Details zu Port/Protokoll/Tag

/network-architect design

Interaktive Sitzung zum Entwurf von Firewall-Richtlinien. Fragt nach Ihren Diensten, Zugriffsanforderungen und Segmentierungsbedürfnissen und schlägt dann Folgendes vor:

• Rollenstruktur (was jeder Host-Typ IST)

• Tag-Taxonomie (Zugriffs-Tags wie ssh:allow, Identitäts-Tags wie user-type:admin)

• Firewall-Regeln pro Rolle im Tabellenformat mit UND-Logik (Rolle + Tags)

/network-architect apply

Implementiert einen Netzwerkentwurf unter Verwendung atomarer Tools (add_firewall_rule, add_host_tag usw.). Liest zuerst den aktuellen Status, zeigt einen Diff an, bittet um Bestätigung und verifiziert nach der Anwendung.

Lizenz

MIT