Skip to main content
Glama

Inicio rápido

# Install dependencies
npm install

# Build
npm run build

# Run in MCP mode (Claude, Kiro, Cursor)
npm start

# Run with write actions enabled
npm run start:actions

# Run as HTTP server for local LLMs
npm run serve

# Check version and tool count
node dist/index.js --version

# List all available tools
node dist/index.js --list-tools

Related MCP server: AETHER_01

Configuración de MCP

Añade a la configuración de tu cliente MCP (Claude Desktop, Kiro, Cursor):

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

Con acciones habilitadas:

{
  "mcpServers": {
    "winfolio": {
      "command": "node",
      "args": ["C:/path/to/winfolio-mcp/dist/index.js", "--allow-actions"]
    }
  }
}

Modo HTTP (compatible con OpenAI)

npm run serve
# Server starts on http://localhost:7890

# Custom port
node dist/index.js --serve --port=8080

Endpoints:

  • GET / — Información del servidor y lista de herramientas

  • GET /v1/tools — Herramientas en formato de llamada a funciones de OpenAI

  • POST /v1/tools/:name — Invoca una herramienta directamente

  • POST /v1/chat/completions — Chat compatible con OpenAI con enrutamiento automático de herramientas

Herramientas (85 en total)

Diagnóstico básico (7)

Tool

Description

system_overview

CPU, RAM, tiempo de actividad, versión del SO con recomendaciones de salud

top_processes

Principales consumidores de CPU/memoria con detección de acaparadores de recursos

port_check

Puertos en escucha con detección de conflictos para puertos de desarrollo

services_status

Salud de los servicios de Windows, monitoreo de servicios críticos

event_log_errors

Errores recientes con explicaciones en lenguaje sencillo

disk_usage

Análisis de espacio en disco con sugerencias de limpieza

startup_programs

Programas de inicio con recomendaciones de desactivación segura

Sistema y SO (4)

Tool

Description

windows_license

Estado de activación, edición, tipo de licencia

virtual_memory

Configuración del archivo de paginación, carga de confirmación, análisis de intercambio

time_sync

Servidor NTP, desviación del reloj, servicio W32Time

system_errors

Eventos críticos/error categorizados (disco, controlador, red, etc.)

Hardware (6)

Tool

Description

gpu_status

Modelo de GPU, VRAM, versión del controlador, utilización

battery_status

Carga, % de salud, número de ciclos, tiempo restante

thermal_status

Temperaturas de CPU/sistema, detección de sobrecalentamiento

ram_details

Ranuras DIMM, velocidad, tipo, potencial de actualización

bios_info

Versión de UEFI/BIOS, Secure Boot, estado de TPM

display_info

Monitores, resolución, frecuencia de actualización, escala

Redes (9)

Tool

Description

network_info

Adaptadores, IP, DNS, puerta de enlace, IP pública

wifi_networks

Redes visibles, intensidad de señal, perfiles guardados

active_connections

Conexiones TCP agrupadas por proceso (netstat)

hosts_file

Entradas de hosts con detección de redirecciones sospechosas

vpn_status

VPN conectadas, detección de adaptadores de terceros

proxy_settings

Proxy del sistema, WPAD, proxies de variables de entorno

network_speed

Velocidades de enlace del adaptador, estadísticas de rendimiento

bluetooth_devices

Dispositivos emparejados, niveles de batería, estado de conexión

audio_devices

Dispositivos de reproducción/grabación, estado

Almacenamiento y limpieza (2)

Tool

Description

large_files

Encuentra los archivos más grandes del disco por tamaño

duplicate_files

Encuentra archivos idénticos que desperdician espacio (hash MD5)

Rendimiento y solución de problemas (4)

Tool

Description

memory_leaks

Detecta procesos con memoria creciente, manejadores excesivos

crash_dumps

Minivolcados de BSOD, fallos de aplicaciones, frecuencia de fallos

pending_reboots

Comprueba todas las banderas de reinicio requerido

slow_boot_analysis

Fases del tiempo de arranque, elementos de inicio lentos

Seguridad (7)

Tool

Description

firewall_status

Estados de perfil, número de reglas, bloqueos recientes

defender_status

Protección en tiempo real, definiciones, amenazas

open_shares

Recursos compartidos SMB con auditoría de permisos

user_accounts

Cuentas locales, auditoría de administradores, antigüedad de contraseñas

bitlocker_status

Estado de cifrado de unidades por volumen

exploit_protection

DEP, ASLR, CFG, HVCI, Credential Guard

privacy_settings

Telemetría, ID de publicidad, ubicación, cámara/micrófono

Herramientas de desarrollo (12)

Tool

Description

dev_environments

SDK instalados (Node, Python, .NET, Java, Go, Rust)

git_repos

Repositorios con cambios sin confirmar/sin enviar

npm_global_packages

Paquetes globales, detección de obsoletos

vscode_extensions

Extensiones con marcado de pesadas/obsoletas

ssh_keys

Inventario de claves, auditoría de frases de contraseña, estado del agente

wsl_disk_usage

Tamaños de VHD de WSL, recomendaciones de compactación

localhost_servers

Escaneo de puertos de desarrollo (qué se está ejecutando localmente)

dotnet_sdks

Versiones de SDK/tiempo de ejecución de .NET, verificación de global.json

docker_status

Contenedores, imágenes, estado del demonio

wsl_status

Distribuciones, versiones, estado de ejecución

installed_software

Programas con detección de bloatware

environment_variables

Análisis de PATH, variables de entorno clave

Mantenimiento (8)

Tool

Description

windows_updates

Actualizaciones pendientes, historial, salud de actualización automática

scheduled_tasks

Tareas no del sistema, detección de tareas fallidas

windows_features

Características opcionales (Hyper-V, WSL, IIS, Sandbox)

startup_impact

Elementos de inicio con calificación de impacto en el arranque

driver_issues

Controladores faltantes/fallidos/desactualizados

windows_search

Estado del indexador, tamaño del índice

certificate_store

Certificados SSL por vencer/vencidos

system_restore_points

Puntos de restauración, antigüedad, desencadenantes de creación

Monitorización (2)

Tool

Description

uptime_history

Eventos de arranque/apagado, puntuación de estabilidad

performance_baseline

Instantánea y comparación de métricas del sistema a lo largo del tiempo

Flujo de trabajo y productividad (3)

Tool

Description

clipboard_history

Portapapeles actual, entradas del historial

recent_files

Archivos de acceso reciente con búsqueda

power_plan

Plan activo, detección de limitación

Automatización (2)

Tool

Description

powershell_profile

Tiempo de carga del perfil, auditoría de importaciones de módulos

startup_services

Servicios de inicio automático, detección de fallos

Diagnóstico adicional (5)

Tool

Description

font_list

Fuentes instaladas con búsqueda

usb_devices

Periféricos y unidades USB conectados

disk_health

Datos S.M.A.R.T., nivel de desgaste, predicción de fallos de unidad

screen_recording

Detecta software activo de grabación/compartición

task_manager_summary

Instantánea integral de CPU/RAM/Disco/Red/GPU

Integraciones (2)

Tool

Description

ollama_models

Inventario de modelos locales de Ollama

system_report

Genera un informe de salud completo en Markdown

Acciones de escritura (12, requieren --allow-actions)

Tool

Description

kill_process

Termina un proceso por PID o nombre

restart_service

Reinicia/inicia/detiene un servicio de Windows

free_port

Mata el proceso que ocupa un puerto

clear_temp_files

Elimina archivos temporales para liberar espacio

flush_dns

Limpia la caché del resolutor de DNS

empty_recycle_bin

Elimina permanentemente el contenido de la Papelera de reciclaje

toggle_dark_mode

Cambia el tema oscuro/claro de Windows

restart_computer

Programa un reinicio del sistema

disable_startup_item

Desactiva un programa de inicio

create_restore_point

Crea un punto de restauración del sistema

set_power_plan

Cambia el plan de energía (Equilibrado/Alto rendimiento/etc.)

toast_notify

Envía una notificación nativa de Windows

Arquitectura

src/
  index.ts              — Entry point, CLI flags, MCP/HTTP transport selection
  powershell.ts         — AV-safe PowerShell executor (temp .ps1 files)
  http-server.ts        — Hono-based OpenAI-compatible HTTP server
  tools/
    registry.ts         — Unified tool registry (both transports consume this)
    *.ts                — Individual tool implementations

Decisiones clave de diseño:

  • Ejecución segura para antivirus: Los scripts de PowerShell se escriben en archivos .ps1 temporales y se ejecutan con la bandera -File (no -EncodedCommand, que activa las heurísticas del antivirus)

  • Registro unificado: Una única definición de herramienta consumida por los transportes MCP y HTTP

  • Degradación elegante: Las herramientas detectan cuando las funciones no están disponibles (Docker no instalado, sin adaptador WiFi, etc.) y devuelven mensajes útiles en lugar de errores

  • Recomendaciones accionables: Cada herramienta devuelve no solo datos, sino qué hacer al respecto

  • Acciones de escritura controladas: Las operaciones peligrosas requieren la bandera explícita --allow-actions

Banderas de CLI

Bandera

Descripción

--serve

Iniciar servidor HTTP en lugar de MCP stdio

--port=N

Puerto del servidor HTTP (predeterminado: 7890)

--allow-actions

Habilitar herramientas de acción de escritura

--version, -v

Imprimir versión y número de herramientas

--list-tools

Imprimir todas las herramientas con descripciones

Requisitos

  • Windows 10/11

  • Node.js 20+

  • PowerShell 5.1+ (incluido con Windows)

Licencia

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables AI assistants to manage, monitor, and diagnose Windows systems through 42 tools across 8 modules, including services, event viewer, task scheduler, processes, network, diagnostics, observability, and safety features.
    19 npm
    9
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to perform extensive Windows system administration, file operations, process management, network configuration, registry editing, GUI automation, and more through a comprehensive set of MCP tools.
    1
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI clients to securely control and interact with a local Windows machine through 218 configurable tools for files, Git, processes, Windows UI, browser automation, WSL, Office, recovery, skills, and child MCP servers.
    7 npm
    MIT