Funcionalidaddraftcreado Thu Oct 01#asistente #mcp #mcp-v3 #racks #network #monitoring #signage #ups

Servidor MCP v3: herramientas de solo lectura (tandas 2 a 5)

User value

Quien conecta su asistente de IA a CreaRack (Claude u otro cliente MCP) puede ahora preguntar por armarios, planos, red, monitorización, SAI y cartelería digital, además de lo que ya veía del WiFi. El asistente responde con los mismos datos y permisos que ve esa persona en la web: si no tiene acceso a un módulo, la herramienta no le devuelve nada de él. Todo es de solo lectura.

Herramientas nuevas (30; 51 en total)

Módulo	Herramientas
Armarios y planos (`racks.py`)	`list_racks`, `get_rack`, `find_rack_device`, `list_rack_groups`, `list_blueprints`, `get_blueprint_status`
Red, Observatory y Agente (`network.py`, `network_metrics.py`)	`list_network_devices`, `get_network_device`, `get_device_metrics`, `list_config_backups` (solo metadatos), `get_port_connections`, `get_local_agent_status`
Monitorización (`monitoring.py`, `monitoring_cns.py`)	`list_alert_rules`, `get_device_availability`, `list_chart_notes`, `list_maintenance_windows`, `list_ai_insights`, `get_ai_insight`, `get_incident_metrics` (MTTA/MTTR), `search_knowledge`
SAI (`ups.py`)	`get_ups_detail`, `get_ups_fleet_summary`, `get_ups_group_summary`
Cartelería (`signage.py`)	`list_signage_players`, `get_signage_player`, `list_playlists`, `get_playlist`, `list_schedules`, `get_playback_stats`, `get_media_library_stats`

Decisiones de diseño

Mismos permisos y módulos de plan que la web: p. ej. cartelería exige el módulo digital-signage y el permiso signage:view; IP y profile_id de un equipo en racks solo con permiso de red.
Datos que nunca salen: management_config, model_data entero, credenciales, capturas de pantalla, URLs de contenido, proyectos de cliente, volcados SNMP, límites de potencia/peso y secretos en textos o comandos.
Honestidad del dato: disponibilidad calculada desde el registro de caídas, down_for con su duración real, MTTA/MTTR a None si no hay datos, y error explícito en SAI si VictoriaMetrics no responde (no ceros inventados).
Estado en vivo solo desde Observatory; el Agente local figura online por frescura de su último contacto.
Métricas con paso de ~96 puntos y topk de interfaces para acotar el tamaño de la respuesta.
Registro único y TOOL_NAMES unificados en mcp_server/tools/__init__.py; network_metrics.py y monitoring_cns.py nacen por el tope de 500 LOC por módulo.

Proceso de construcción

Cuatro constructores Sonnet en worktrees, cada tanda revisada por un refutador Opus y retrabajada antes de juntarlas (commits fix(asistente): retrabajo de la tanda ...). Los tests de las tandas (tests/api/test_mcp_*.py) se escribieron sin ejecutarse en local; los valida el CI.

Commits relacionados

5d0f1d17 — 2026-10-01 — PR #663 (v1.177.0).
Precedentes: PR #660 (tanda 1, v1.176.0) y PR #659 (protocolo 2026-07-28).

Relacionada con [[feature—asistente—servidor-mcp-entrega-1]] y [[crearack-tech—backend—mcp-server]] — considerar fusión de la lista de herramientas en la página técnica del servidor.

Véase también

[[feature—asistente—servidor-mcp-entrega-1]]
[[feature—asistente—mcp-conexiones-actividad]]
[[crearack-tech—backend—mcp-server]]
[[concept—saas—multi-tenancy]]
[[feature—monitoring—registro-caidas-equipos]]
[[feature—signage—s121-permisos-rol-y-seguridad]]