winfolio
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-toolsRelated 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=8080Endpoints:
GET /— Información del servidor y lista de herramientasGET /v1/tools— Herramientas en formato de llamada a funciones de OpenAIPOST /v1/tools/:name— Invoca una herramienta directamentePOST /v1/chat/completions— Chat compatible con OpenAI con enrutamiento automático de herramientas
Herramientas (85 en total)
Diagnóstico básico (7)
Tool | Description |
| CPU, RAM, tiempo de actividad, versión del SO con recomendaciones de salud |
| Principales consumidores de CPU/memoria con detección de acaparadores de recursos |
| Puertos en escucha con detección de conflictos para puertos de desarrollo |
| Salud de los servicios de Windows, monitoreo de servicios críticos |
| Errores recientes con explicaciones en lenguaje sencillo |
| Análisis de espacio en disco con sugerencias de limpieza |
| Programas de inicio con recomendaciones de desactivación segura |
Sistema y SO (4)
Tool | Description |
| Estado de activación, edición, tipo de licencia |
| Configuración del archivo de paginación, carga de confirmación, análisis de intercambio |
| Servidor NTP, desviación del reloj, servicio W32Time |
| Eventos críticos/error categorizados (disco, controlador, red, etc.) |
Hardware (6)
Tool | Description |
| Modelo de GPU, VRAM, versión del controlador, utilización |
| Carga, % de salud, número de ciclos, tiempo restante |
| Temperaturas de CPU/sistema, detección de sobrecalentamiento |
| Ranuras DIMM, velocidad, tipo, potencial de actualización |
| Versión de UEFI/BIOS, Secure Boot, estado de TPM |
| Monitores, resolución, frecuencia de actualización, escala |
Redes (9)
Tool | Description |
| Adaptadores, IP, DNS, puerta de enlace, IP pública |
| Redes visibles, intensidad de señal, perfiles guardados |
| Conexiones TCP agrupadas por proceso (netstat) |
| Entradas de hosts con detección de redirecciones sospechosas |
| VPN conectadas, detección de adaptadores de terceros |
| Proxy del sistema, WPAD, proxies de variables de entorno |
| Velocidades de enlace del adaptador, estadísticas de rendimiento |
| Dispositivos emparejados, niveles de batería, estado de conexión |
| Dispositivos de reproducción/grabación, estado |
Almacenamiento y limpieza (2)
Tool | Description |
| Encuentra los archivos más grandes del disco por tamaño |
| Encuentra archivos idénticos que desperdician espacio (hash MD5) |
Rendimiento y solución de problemas (4)
Tool | Description |
| Detecta procesos con memoria creciente, manejadores excesivos |
| Minivolcados de BSOD, fallos de aplicaciones, frecuencia de fallos |
| Comprueba todas las banderas de reinicio requerido |
| Fases del tiempo de arranque, elementos de inicio lentos |
Seguridad (7)
Tool | Description |
| Estados de perfil, número de reglas, bloqueos recientes |
| Protección en tiempo real, definiciones, amenazas |
| Recursos compartidos SMB con auditoría de permisos |
| Cuentas locales, auditoría de administradores, antigüedad de contraseñas |
| Estado de cifrado de unidades por volumen |
| DEP, ASLR, CFG, HVCI, Credential Guard |
| Telemetría, ID de publicidad, ubicación, cámara/micrófono |
Herramientas de desarrollo (12)
Tool | Description |
| SDK instalados (Node, Python, .NET, Java, Go, Rust) |
| Repositorios con cambios sin confirmar/sin enviar |
| Paquetes globales, detección de obsoletos |
| Extensiones con marcado de pesadas/obsoletas |
| Inventario de claves, auditoría de frases de contraseña, estado del agente |
| Tamaños de VHD de WSL, recomendaciones de compactación |
| Escaneo de puertos de desarrollo (qué se está ejecutando localmente) |
| Versiones de SDK/tiempo de ejecución de .NET, verificación de global.json |
| Contenedores, imágenes, estado del demonio |
| Distribuciones, versiones, estado de ejecución |
| Programas con detección de bloatware |
| Análisis de PATH, variables de entorno clave |
Mantenimiento (8)
Tool | Description |
| Actualizaciones pendientes, historial, salud de actualización automática |
| Tareas no del sistema, detección de tareas fallidas |
| Características opcionales (Hyper-V, WSL, IIS, Sandbox) |
| Elementos de inicio con calificación de impacto en el arranque |
| Controladores faltantes/fallidos/desactualizados |
| Estado del indexador, tamaño del índice |
| Certificados SSL por vencer/vencidos |
| Puntos de restauración, antigüedad, desencadenantes de creación |
Monitorización (2)
Tool | Description |
| Eventos de arranque/apagado, puntuación de estabilidad |
| Instantánea y comparación de métricas del sistema a lo largo del tiempo |
Flujo de trabajo y productividad (3)
Tool | Description |
| Portapapeles actual, entradas del historial |
| Archivos de acceso reciente con búsqueda |
| Plan activo, detección de limitación |
Automatización (2)
Tool | Description |
| Tiempo de carga del perfil, auditoría de importaciones de módulos |
| Servicios de inicio automático, detección de fallos |
Diagnóstico adicional (5)
Tool | Description |
| Fuentes instaladas con búsqueda |
| Periféricos y unidades USB conectados |
| Datos S.M.A.R.T., nivel de desgaste, predicción de fallos de unidad |
| Detecta software activo de grabación/compartición |
| Instantánea integral de CPU/RAM/Disco/Red/GPU |
Integraciones (2)
Tool | Description |
| Inventario de modelos locales de Ollama |
| Genera un informe de salud completo en Markdown |
Acciones de escritura (12, requieren --allow-actions)
Tool | Description |
| Termina un proceso por PID o nombre |
| Reinicia/inicia/detiene un servicio de Windows |
| Mata el proceso que ocupa un puerto |
| Elimina archivos temporales para liberar espacio |
| Limpia la caché del resolutor de DNS |
| Elimina permanentemente el contenido de la Papelera de reciclaje |
| Cambia el tema oscuro/claro de Windows |
| Programa un reinicio del sistema |
| Desactiva un programa de inicio |
| Crea un punto de restauración del sistema |
| Cambia el plan de energía (Equilibrado/Alto rendimiento/etc.) |
| 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 implementationsDecisiones clave de diseño:
Ejecución segura para antivirus: Los scripts de PowerShell se escriben en archivos
.ps1temporales 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 |
| Iniciar servidor HTTP en lugar de MCP stdio |
| Puerto del servidor HTTP (predeterminado: 7890) |
| Habilitar herramientas de acción de escritura |
| Imprimir versión y número de herramientas |
| Imprimir todas las herramientas con descripciones |
Requisitos
Windows 10/11
Node.js 20+
PowerShell 5.1+ (incluido con Windows)
Licencia
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
- ZionDeskOAuthapp.ziondesk
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn 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 npm9MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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.1MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to control Windows PCs by executing shell commands, managing files, capturing screenshots, and monitoring system information through a comprehensive set of MCP tools.181MIT
- AlicenseNot gradedqualityAmaintenanceEnables 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 npmMIT