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: WinScript

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

A
license - permissive license
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    A MCP server for Windows/Linux that provides 90+ tools enabling AI assistants to systematically manage local systems, including system probing, command execution, file editing, network diagnostics, and more.
    12
    MIT
  • 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.
    32
    8
    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

View all related MCP servers

Related MCP Connectors

  • Free public MCP for AI agents — 193 tools, 44 workflows. No API key.

  • Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.

  • OCR, transcription, file extraction, and image generation for AI agents via MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/reprodev/winfolio-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server