defined-mcp

Servidor MCP para la API de Defined Networking.

Instalación

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

Para instalar una versión o rama específica:

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

Para desarrollo local:

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

Related MCP server: UniFi MCP Server

Configuración

Establece la variable de entorno DEFINED_API_KEY con tu clave de API de Defined Networking. Obtén una desde tu panel de administración.

export DEFINED_API_KEY=dnkey-...

Uso

Añadir a Claude Code

claude mcp add defined_mcp -- defined-mcp serve

Luego reinicia Claude Code.

Verificar conectividad

defined-mcp check

Ejecutar de forma independiente

defined-mcp serve

Herramientas disponibles

Hosts

• list_hosts — Listar hosts con filtros (rol, bloqueado, lighthouse, relay)

• get_host — Obtener detalles de un host

• create_host — Crear un host/lighthouse/relay

• update_host — Actualizar un host (reemplazo completo)

• delete_host — Eliminar un host

• block_host / unblock_host — Bloquear/desbloquear un host

• add_host_tag / remove_host_tag — Añadir/eliminar una etiqueta en un host

• create_enrollment_code — Generar código de inscripción

• create_host_and_enrollment_code — Crear host + código de inscripción

Roles y reglas de firewall

• list_roles / get_role — Listar/obtener roles con reglas de firewall

• create_role / update_role — Crear/actualizar roles (reemplazo completo)

• delete_role — Eliminar un rol

• add_firewall_rule — Añadir una regla de firewall a un rol (parámetros planos, sin JSON)

• remove_firewall_rule — Eliminar una regla de firewall por índice

Etiquetas

• list_tags / get_tag — Listar/obtener etiquetas

• create_tag / update_tag — Crear/actualizar etiquetas con anulaciones de configuración

• delete_tag — Eliminar una etiqueta

• add_tag_config_override — Añadir/reemplazar una anulación de configuración en una etiqueta

• remove_tag_config_override — Eliminar una anulación de configuración por clave

Redes

• list_networks / get_network — Listar/obtener redes

• create_network / update_network — Crear/actualizar redes

Rutas

• list_routes / get_route — Listar/obtener rutas con reglas de firewall

• create_route / update_route — Crear/actualizar rutas (reemplazo completo)

• delete_route — Eliminar una ruta

• add_route_firewall_rule — Añadir una regla de firewall a una ruta

• remove_route_firewall_rule — Eliminar una regla de firewall de ruta por índice

Otros

• list_audit_logs — Registro de auditoría con filtros

• list_downloads — Enlaces de descarga de software (sin autenticación)

Habilidades de Claude Code

Este repositorio incluye una habilidad de Claude Code para la gestión interactiva de redes. Cuando ejecutas Claude Code desde este repositorio, el comando /network-architect está disponible automáticamente.

Para usar la habilidad desde cualquier proyecto, cópiala a tu perfil de Claude Code:

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

/network-architect audit

Realiza una auditoría de seguridad y configuración de tu cuenta de Defined Networking. Obtiene todas las redes, roles, etiquetas y hosts, y luego informa sobre:

• Roles con reglas de firewall faltantes o demasiado permisivas

• Etiquetas muertas (cero hosts asignados)

• Hosts sin etiquetas, versiones de dnclient obsoletas o tiempos de última conexión antiguos

• Resumen de cobertura de firewall por rol con detalles de puerto/protocolo/etiqueta

/network-architect design

Sesión interactiva de diseño de políticas de firewall. Pregunta sobre tus servicios, requisitos de acceso y necesidades de segmentación, y luego propone:

• Estructura de roles (qué ES cada tipo de host)

• Taxonomía de etiquetas (etiquetas de acceso como ssh:allow, etiquetas de identidad como user-type:admin)

• Reglas de firewall por rol en formato de tabla con lógica AND (rol + etiquetas)

/network-architect apply

Implementa un diseño de red utilizando herramientas atómicas (add_firewall_rule, add_host_tag, etc.). Lee primero el estado actual, muestra una diferencia, solicita confirmación y luego verifica después de aplicar.

Licencia

MIT