winfolio
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-toolsRelated 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=8080Endpunkte:
GET /— Serverinformationen und Tool-ListeGET /v1/tools— Tools im OpenAI-Funktionsaufruf-FormatPOST /v1/tools/:name— Tool direkt aufrufenPOST /v1/chat/completions— OpenAI-kompatibler Chat mit automatischem Tool-Routing
Tools (85 insgesamt)
Kerndiagnose (7)
Tool | Beschreibung |
| CPU, RAM, Betriebszeit, OS-Version mit Gesundheitsempfehlungen |
| Top-CPU-/Speicherverbraucher mit Erkennung von Ressourcenfressern |
| Lauschende Ports mit Konflikterkennung für Entwickler-Ports |
| Windows-Dienste-Gesundheit, Überwachung kritischer Dienste |
| Aktuelle Fehler mit verständlichen Erklärungen |
| Laufwerksplatz-Analyse mit Bereinigungsvorschlägen |
| Startprogramme mit Empfehlungen zum sicheren Deaktivieren |
System & Betriebssystem (4)
Tool | Beschreibung |
| Aktivierungsstatus, Edition, Lizenztyp |
| Auslagerungsdatei-Konfiguration, Auslastung, Swap-Analyse |
| NTP-Server, Uhrzeitabweichung, W32Time-Dienst |
| Kategorisierte kritische/Fehlerereignisse (Festplatte, Treiber, Netzwerk usw.) |
Hardware (6)
Tool | Beschreibung |
| GPU-Modell, VRAM, Treiberversion, Auslastung |
| Ladung, Gesundheitszustand %, Zyklenzahl, verbleibende Zeit |
| CPU-/Systemtemperaturen, Überhitzungserkennung |
| DIMM-Steckplätze, Geschwindigkeit, Typ, Aufrüstungspotenzial |
| UEFI/BIOS-Version, Secure Boot, TPM-Status |
| Monitore, Auflösung, Bildwiederholfrequenz, Skalierung |
Netzwerk (9)
Tool | Beschreibung |
| Adapter, IP, DNS, Gateway, öffentliche IP |
| Sichtbare Netzwerke, Signalstärke, gespeicherte Profile |
| TCP-Verbindungen nach Prozess gruppiert (netstat) |
| Hosts-Einträge mit Erkennung verdächtiger Weiterleitungen |
| Verbundene VPNs, Erkennung von Drittanbieter-Adaptern |
| System-Proxy, WPAD, Proxy-Umgebungsvariablen |
| Adapter-Linkgeschwindigkeiten, Durchsatzstatistiken |
| Gekoppelte Geräte, Akkustände, Verbindungsstatus |
| Wiedergabe-/Aufnahmegeräte, Status |
Speicher & Bereinigung (2)
Tool | Beschreibung |
| Größte Dateien auf der Festplatte nach Größe finden |
| Identische Dateien finden, die Speicherplatz verschwenden (MD5-Hash) |
Leistung & Fehlerbehebung (4)
Tool | Beschreibung |
| Prozesse mit wachsendem Speicher und übermäßigen Handles erkennen |
| BSOD-Minidumps, App-Abstürze, Absturzhäufigkeit |
| Alle Neustart-erforderlich-Flags prüfen |
| Boot-Zeitphasen, langsame Startelemente |
Sicherheit (7)
Tool | Beschreibung |
| Profilzustände, Regelanzahl, letzte Blockierungen |
| Echtzeitschutz, Definitionen, Bedrohungen |
| SMB-Freigaben mit Berechtigungsprüfung |
| Lokale Konten, Admin-Prüfung, Passwortalter |
| Laufwerksverschlüsselungsstatus pro Volume |
| DEP, ASLR, CFG, HVCI, Credential Guard |
| Telemetrie, Werbe-ID, Standort, Kamera/Mikrofon |
Entwickler-Tools (12)
Tool | Beschreibung |
| Installierte SDKs (Node, Python, .NET, Java, Go, Rust) |
| Repos mit nicht committeten/nicht gepushten Änderungen |
| Globale Pakete, Erkennung veralteter Pakete |
| Erweiterungen mit Kennzeichnung als schwer/veraltet |
| Schlüsselbestand, Passphrase-Prüfung, Agentenstatus |
| WSL-VHD-Größen, Komprimierungsempfehlungen |
| Scan der Entwickler-Ports (was läuft lokal) |
| .NET SDK/Laufzeitversionen, global.json-Überprüfung |
| Container, Images, Daemon-Status |
| Distributionen, Versionen, Ausführungsstatus |
| Programme mit Bloatware-Erkennung |
| PATH-Analyse, wichtige Umgebungsvariablen |
Wartung (8)
Tool | Beschreibung |
| Ausstehende Updates, Verlauf, Auto-Update-Gesundheit |
| Nicht-System-Aufgaben, Erkennung fehlgeschlagener Aufgaben |
| Optionale Features (Hyper-V, WSL, IIS, Sandbox) |
| Startelemente mit Boot-Auswirkungsbewertung |
| Fehlende/fehlgeschlagene/veraltete Treiber |
| Indexer-Status, Indexgröße |
| Ablaufende/abgelaufene SSL-Zertifikate |
| Wiederherstellungspunkte, Alter, Erstellungsauslöser |
Überwachung (2)
Tool | Beschreibung |
| Boot-/Herunterfahren-Ereignisse, Stabilitätsbewertung |
| Systemmetriken im Zeitverlauf erfassen und vergleichen |
Workflow & Produktivität (3)
Tool | Beschreibung |
| Aktuelle Zwischenablage, Verlaufseinträge |
| Zuletzt verwendete Dateien mit Suche |
| Aktiver Plan, Erkennung von Drosselung |
Automatisierung (2)
Tool | Beschreibung |
| Profil-Ladezeit, Prüfung der Modulimporte |
| Autostart-Dienste, Erkennung fehlgeschlagener Dienste |
Zusätzliche Diagnose (5)
Tool | Beschreibung |
| Installierte Schriftarten mit Suche |
| Verbundene USB-Peripheriegeräte und Laufwerke |
| S.M.A.R.T.-Daten, Abnutzungsgrad, Vorhersage von Laufwerksfehlern |
| Aktive Aufnahme-/Freigabesoftware erkennen |
| All-in-one-Snapshot von CPU/RAM/Disk/Netzwerk/GPU |
Integrationen (2)
Tool | Beschreibung |
| Lokale Ollama-Modellinventur |
| Vollständigen Markdown-Gesundheitsbericht erstellen |
Schreibaktionen (12, erfordert --allow-actions)
Tool | Beschreibung |
| Einen Prozess per PID oder Name beenden |
| Einen Windows-Dienst neu starten/starten/stoppen |
| Den Prozess beenden, der einen Port belegt |
| Temporäre Dateien löschen, um Speicherplatz freizugeben |
| DNS-Resolver-Cache leeren |
| Inhalte des Papierkorbs dauerhaft löschen |
| Windows-Dark-/Light-Theme wechseln |
| Einen Systemneustart planen |
| Ein Startprogramm deaktivieren |
| Einen Systemwiederherstellungspunkt erstellen |
| Energieschema wechseln (Ausbalanciert/Höchstleistung usw.) |
| 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 implementationsWichtige 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 |
| HTTP-Server statt MCP stdio starten |
| HTTP-Server-Port (Standard: 7890) |
| Schreibaktionstools aktivieren |
| Version und Tool-Anzahl ausgeben |
| Alle Tools mit Beschreibungen ausgeben |
Anforderungen
Windows 10/11
Node.js 20+
PowerShell 5.1+ (in Windows enthalten)
Lizenz
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