Skip to main content
Glama

Schnellstart

# 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

MCP-Konfiguration

Fügen Sie zu Ihrer MCP-Client-Konfiguration hinzu (Claude Desktop, Kiro, Cursor):

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

Mit aktivierten Aktionen:

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

HTTP-Modus (OpenAI-kompatibel)

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

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

Endpunkte:

  • GET / — Serverinformationen und Tool-Liste

  • GET /v1/tools — Tools im OpenAI-Funktionsaufruf-Format

  • POST /v1/tools/:name — Tool direkt aufrufen

  • POST /v1/chat/completions — OpenAI-kompatibler Chat mit automatischem Tool-Routing

Tools (85 insgesamt)

Kerndiagnose (7)

Tool

Beschreibung

system_overview

CPU, RAM, Betriebszeit, OS-Version mit Gesundheitsempfehlungen

top_processes

Top-CPU-/Speicherverbraucher mit Erkennung von Ressourcenfressern

port_check

Lauschende Ports mit Konflikterkennung für Entwickler-Ports

services_status

Windows-Dienste-Gesundheit, Überwachung kritischer Dienste

event_log_errors

Aktuelle Fehler mit verständlichen Erklärungen

disk_usage

Laufwerksplatz-Analyse mit Bereinigungsvorschlägen

startup_programs

Startprogramme mit Empfehlungen zum sicheren Deaktivieren

System & Betriebssystem (4)

Tool

Beschreibung

windows_license

Aktivierungsstatus, Edition, Lizenztyp

virtual_memory

Auslagerungsdatei-Konfiguration, Auslastung, Swap-Analyse

time_sync

NTP-Server, Uhrzeitabweichung, W32Time-Dienst

system_errors

Kategorisierte kritische/Fehlerereignisse (Festplatte, Treiber, Netzwerk usw.)

Hardware (6)

Tool

Beschreibung

gpu_status

GPU-Modell, VRAM, Treiberversion, Auslastung

battery_status

Ladung, Gesundheitszustand %, Zyklenzahl, verbleibende Zeit

thermal_status

CPU-/Systemtemperaturen, Überhitzungserkennung

ram_details

DIMM-Steckplätze, Geschwindigkeit, Typ, Aufrüstungspotenzial

bios_info

UEFI/BIOS-Version, Secure Boot, TPM-Status

display_info

Monitore, Auflösung, Bildwiederholfrequenz, Skalierung

Netzwerk (9)

Tool

Beschreibung

network_info

Adapter, IP, DNS, Gateway, öffentliche IP

wifi_networks

Sichtbare Netzwerke, Signalstärke, gespeicherte Profile

active_connections

TCP-Verbindungen nach Prozess gruppiert (netstat)

hosts_file

Hosts-Einträge mit Erkennung verdächtiger Weiterleitungen

vpn_status

Verbundene VPNs, Erkennung von Drittanbieter-Adaptern

proxy_settings

System-Proxy, WPAD, Proxy-Umgebungsvariablen

network_speed

Adapter-Linkgeschwindigkeiten, Durchsatzstatistiken

bluetooth_devices

Gekoppelte Geräte, Akkustände, Verbindungsstatus

audio_devices

Wiedergabe-/Aufnahmegeräte, Status

Speicher & Bereinigung (2)

Tool

Beschreibung

large_files

Größte Dateien auf der Festplatte nach Größe finden

duplicate_files

Identische Dateien finden, die Speicherplatz verschwenden (MD5-Hash)

Leistung & Fehlerbehebung (4)

Tool

Beschreibung

memory_leaks

Prozesse mit wachsendem Speicher und übermäßigen Handles erkennen

crash_dumps

BSOD-Minidumps, App-Abstürze, Absturzhäufigkeit

pending_reboots

Alle Neustart-erforderlich-Flags prüfen

slow_boot_analysis

Boot-Zeitphasen, langsame Startelemente

Sicherheit (7)

Tool

Beschreibung

firewall_status

Profilzustände, Regelanzahl, letzte Blockierungen

defender_status

Echtzeitschutz, Definitionen, Bedrohungen

open_shares

SMB-Freigaben mit Berechtigungsprüfung

user_accounts

Lokale Konten, Admin-Prüfung, Passwortalter

bitlocker_status

Laufwerksverschlüsselungsstatus pro Volume

exploit_protection

DEP, ASLR, CFG, HVCI, Credential Guard

privacy_settings

Telemetrie, Werbe-ID, Standort, Kamera/Mikrofon

Entwickler-Tools (12)

Tool

Beschreibung

dev_environments

Installierte SDKs (Node, Python, .NET, Java, Go, Rust)

git_repos

Repos mit nicht committeten/nicht gepushten Änderungen

npm_global_packages

Globale Pakete, Erkennung veralteter Pakete

vscode_extensions

Erweiterungen mit Kennzeichnung als schwer/veraltet

ssh_keys

Schlüsselbestand, Passphrase-Prüfung, Agentenstatus

wsl_disk_usage

WSL-VHD-Größen, Komprimierungsempfehlungen

localhost_servers

Scan der Entwickler-Ports (was läuft lokal)

dotnet_sdks

.NET SDK/Laufzeitversionen, global.json-Überprüfung

docker_status

Container, Images, Daemon-Status

wsl_status

Distributionen, Versionen, Ausführungsstatus

installed_software

Programme mit Bloatware-Erkennung

environment_variables

PATH-Analyse, wichtige Umgebungsvariablen

Wartung (8)

Tool

Beschreibung

windows_updates

Ausstehende Updates, Verlauf, Auto-Update-Gesundheit

scheduled_tasks

Nicht-System-Aufgaben, Erkennung fehlgeschlagener Aufgaben

windows_features

Optionale Features (Hyper-V, WSL, IIS, Sandbox)

startup_impact

Startelemente mit Boot-Auswirkungsbewertung

driver_issues

Fehlende/fehlgeschlagene/veraltete Treiber

windows_search

Indexer-Status, Indexgröße

certificate_store

Ablaufende/abgelaufene SSL-Zertifikate

system_restore_points

Wiederherstellungspunkte, Alter, Erstellungsauslöser

Überwachung (2)

Tool

Beschreibung

uptime_history

Boot-/Herunterfahren-Ereignisse, Stabilitätsbewertung

performance_baseline

Systemmetriken im Zeitverlauf erfassen und vergleichen

Workflow & Produktivität (3)

Tool

Beschreibung

clipboard_history

Aktuelle Zwischenablage, Verlaufseinträge

recent_files

Zuletzt verwendete Dateien mit Suche

power_plan

Aktiver Plan, Erkennung von Drosselung

Automatisierung (2)

Tool

Beschreibung

powershell_profile

Profil-Ladezeit, Prüfung der Modulimporte

startup_services

Autostart-Dienste, Erkennung fehlgeschlagener Dienste

Zusätzliche Diagnose (5)

Tool

Beschreibung

font_list

Installierte Schriftarten mit Suche

usb_devices

Verbundene USB-Peripheriegeräte und Laufwerke

disk_health

S.M.A.R.T.-Daten, Abnutzungsgrad, Vorhersage von Laufwerksfehlern

screen_recording

Aktive Aufnahme-/Freigabesoftware erkennen

task_manager_summary

All-in-one-Snapshot von CPU/RAM/Disk/Netzwerk/GPU

Integrationen (2)

Tool

Beschreibung

ollama_models

Lokale Ollama-Modellinventur

system_report

Vollständigen Markdown-Gesundheitsbericht erstellen

Schreibaktionen (12, erfordert --allow-actions)

Tool

Beschreibung

kill_process

Einen Prozess per PID oder Name beenden

restart_service

Einen Windows-Dienst neu starten/starten/stoppen

free_port

Den Prozess beenden, der einen Port belegt

clear_temp_files

Temporäre Dateien löschen, um Speicherplatz freizugeben

flush_dns

DNS-Resolver-Cache leeren

empty_recycle_bin

Inhalte des Papierkorbs dauerhaft löschen

toggle_dark_mode

Windows-Dark-/Light-Theme wechseln

restart_computer

Einen Systemneustart planen

disable_startup_item

Ein Startprogramm deaktivieren

create_restore_point

Einen Systemwiederherstellungspunkt erstellen

set_power_plan

Energieschema wechseln (Ausbalanciert/Höchstleistung usw.)

toast_notify

Eine native Windows-Benachrichtigung senden

Architektur

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

Wichtige Designentscheidungen:

  • AV-sichere Ausführung: PowerShell-Skripte werden in temporäre .ps1-Dateien geschrieben und mit dem -File-Flag ausgeführt (nicht mit -EncodedCommand, das Antiviren-Heuristiken auslöst)

  • Einheitliches Register: Eine einzige Tool-Definition, die von sowohl MCP- als auch HTTP-Transports verwendet wird

  • Sanfte Degradierung: Tools erkennen, wenn Funktionen nicht verfügbar sind (Docker nicht installiert, kein WLAN-Adapter usw.) und geben hilfreiche Meldungen statt Fehlern zurück

  • Umsetzbare Empfehlungen: Jedes Tool liefert nicht nur Daten, sondern auch Handlungsempfehlungen

  • Geschützte Schreibaktionen: Gefährliche Operationen erfordern das explizite --allow-actions-Flag

CLI-Flags

Flag

Beschreibung

--serve

HTTP-Server statt MCP stdio starten

--port=N

HTTP-Server-Port (Standard: 7890)

--allow-actions

Schreibaktionstools aktivieren

--version, -v

Version und Tool-Anzahl ausgeben

--list-tools

Alle Tools mit Beschreibungen ausgeben

Anforderungen

  • Windows 10/11

  • Node.js 20+

  • PowerShell 5.1+ (in Windows enthalten)

Lizenz

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