Which integrations are available for this server?

Provides tools for inspecting Docker containers, images, and daemon status. Provides tools for analyzing Git repositories, including detecting uncommitted and unpushed changes. Provides tools for checking .NET SDK and runtime versions, and verifying global.json files. Provides tools for listing global npm packages and identifying deprecated ones. Provides tools for listing local Ollama models and their inventory.

How do I use winfolio?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@winfolio Run a full system diagnostic and recommend fixes." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

winfolio

by reprodev

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

Quick Start

# 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: windows-admin-mcp

MCP Configuration

Add to your MCP client config (Claude Desktop, Kiro, Cursor):

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

With actions enabled:

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

HTTP Mode (OpenAI-Compatible)

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

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

Endpoints:

GET / — Server info and tool list
GET /v1/tools — Tools in OpenAI function-calling format
POST /v1/tools/:name — Invoke a tool directly
POST /v1/chat/completions — OpenAI-compatible chat with auto tool routing

Tools (85 total)

Core Diagnostics (7)

Tool	Description
`system_overview`	CPU, RAM, uptime, OS version with health recommendations
`top_processes`	Top CPU/memory consumers with resource hog detection
`port_check`	Listening ports with conflict detection for dev ports
`services_status`	Windows services health, critical service monitoring
`event_log_errors`	Recent errors with plain-English explanations
`disk_usage`	Drive space analysis with cleanup suggestions
`startup_programs`	Boot programs with safe-to-disable recommendations

System & OS (4)

Tool	Description
`windows_license`	Activation status, edition, license type
`virtual_memory`	Page file config, commit charge, swap analysis
`time_sync`	NTP server, clock skew, W32Time service
`system_errors`	Categorized critical/error events (disk, driver, network, etc.)

Hardware (6)

Tool	Description
`gpu_status`	GPU model, VRAM, driver version, utilization
`battery_status`	Charge, health %, cycle count, time remaining
`thermal_status`	CPU/system temperatures, overheat detection
`ram_details`	DIMM slots, speed, type, upgrade potential
`bios_info`	UEFI/BIOS version, Secure Boot, TPM status
`display_info`	Monitors, resolution, refresh rate, scaling

Networking (9)

Tool	Description
`network_info`	Adapters, IP, DNS, gateway, public IP
`wifi_networks`	Visible networks, signal strength, saved profiles
`active_connections`	TCP connections grouped by process (netstat)
`hosts_file`	Hosts entries with suspicious redirect detection
`vpn_status`	Connected VPNs, third-party adapter detection
`proxy_settings`	System proxy, WPAD, env var proxies
`network_speed`	Adapter link speeds, throughput stats
`bluetooth_devices`	Paired devices, battery levels, connection status
`audio_devices`	Playback/recording devices, status

Storage & Cleanup (2)

Tool	Description
`large_files`	Find biggest files on disk by size
`duplicate_files`	Find identical files wasting space (MD5 hash)

Performance & Troubleshooting (4)

Tool	Description
`memory_leaks`	Detect processes with growing memory, excessive handles
`crash_dumps`	BSOD minidumps, app crashes, crash frequency
`pending_reboots`	Check all reboot-required flags
`slow_boot_analysis`	Boot time phases, slow startup items

Security (7)

Tool	Description
`firewall_status`	Profile states, rules count, recent blocks
`defender_status`	Real-time protection, definitions, threats
`open_shares`	SMB shares with permission audit
`user_accounts`	Local accounts, admin audit, password age
`bitlocker_status`	Drive encryption status per volume
`exploit_protection`	DEP, ASLR, CFG, HVCI, Credential Guard
`privacy_settings`	Telemetry, advertising ID, location, camera/mic

Developer Tools (12)

Tool	Description
`dev_environments`	Installed SDKs (Node, Python, .NET, Java, Go, Rust)
`git_repos`	Repos with uncommitted/unpushed changes
`npm_global_packages`	Global packages, deprecated detection
`vscode_extensions`	Extensions with heavy/deprecated flagging
`ssh_keys`	Key inventory, passphrase audit, agent status
`wsl_disk_usage`	WSL VHD sizes, compaction recommendations
`localhost_servers`	Dev ports scan (what's running locally)
`dotnet_sdks`	.NET SDK/runtime versions, global.json verification
`docker_status`	Containers, images, daemon status
`wsl_status`	Distros, versions, running state
`installed_software`	Programs with bloatware detection
`environment_variables`	PATH analysis, key env vars

Maintenance (8)

Tool	Description
`windows_updates`	Pending updates, history, auto-update health
`scheduled_tasks`	Non-system tasks, failed task detection
`windows_features`	Optional features (Hyper-V, WSL, IIS, Sandbox)
`startup_impact`	Startup items with boot impact rating
`driver_issues`	Missing/failed/outdated drivers
`windows_search`	Indexer status, index size
`certificate_store`	Expiring/expired SSL certs
`system_restore_points`	Restore points, age, creation triggers

Monitoring (2)

Tool	Description
`uptime_history`	Boot/shutdown events, stability score
`performance_baseline`	Snapshot and compare system metrics over time

Workflow & Productivity (3)

Tool	Description
`clipboard_history`	Current clipboard, history entries
`recent_files`	Recently accessed files with search
`power_plan`	Active plan, throttle detection

Automation (2)

Tool	Description
`powershell_profile`	Profile load time, module imports audit
`startup_services`	Auto-start services, failed detection

Additional Diagnostics (5)

Tool	Description
`font_list`	Installed fonts with search
`usb_devices`	Connected USB peripherals and drives
`disk_health`	S.M.A.R.T. data, wear level, drive failure prediction
`screen_recording`	Detect active recording/sharing software
`task_manager_summary`	All-in-one CPU/RAM/Disk/Network/GPU snapshot

Integrations (2)

Tool	Description
`ollama_models`	Local Ollama model inventory
`system_report`	Generate full Markdown health report

Write Actions (12, require `--allow-actions`)

Tool	Description
`kill_process`	Terminate a process by PID or name
`restart_service`	Restart/start/stop a Windows service
`free_port`	Kill the process holding a port
`clear_temp_files`	Delete temp files to free space
`flush_dns`	Clear DNS resolver cache
`empty_recycle_bin`	Permanently delete Recycle Bin contents
`toggle_dark_mode`	Switch Windows dark/light theme
`restart_computer`	Schedule a system restart
`disable_startup_item`	Disable a startup program
`create_restore_point`	Create a System Restore point
`set_power_plan`	Switch power plan (Balanced/High Performance/etc.)
`toast_notify`	Send a native Windows notification

Architecture

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

Key design decisions:

AV-safe execution: PowerShell scripts written to temp .ps1 files and run with -File flag (not -EncodedCommand which triggers antivirus heuristics)
Unified registry: Single tool definition consumed by both MCP and HTTP transports
Graceful degradation: Tools detect when features aren't available (Docker not installed, no WiFi adapter, etc.) and return helpful messages instead of errors
Actionable recommendations: Every tool returns not just data but what to do about it
Gated write actions: Dangerous operations require explicit --allow-actions flag

CLI Flags

Flag	Description
`--serve`	Start HTTP server instead of MCP stdio
`--port=N`	HTTP server port (default: 7890)
`--allow-actions`	Enable write action tools
`--version`, `-v`	Print version and tool count
`--list-tools`	Print all tools with descriptions

Requirements

Windows 10/11
Node.js 20+
PowerShell 5.1+ (ships with Windows)

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

ToolRouter B
io.github.Humanleap
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
Agent Orchestration Autonomous Agents
481
Anagent A
io.github.jaytahir
A registry of AI agent tools — MCP servers, APIs, CLIs, SDKs — kept current by automated ingestion.
Agent Orchestration Developer Tools
21
nexusOAuth
com.civic
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Agent Orchestration Developer Tools App Automation
2
ToolAPI C
org.toolapi
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
Agent Orchestration Autonomous Agents
19322

Related MCP Servers

allcanuse-mcp
OS Automation Command Line Developer Tools
ra1nyxin
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.
Updated 4 months ago (2026-05-15 15:51 UTC)
13
MIT
windows-admin-mcp
OS Automation Shell Access Observability
devladpopov
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.
Updated 4 months ago (2026-05-18 11:33 UTC)
15 npm
9
MIT
AETHER_01
OS Automation Shell Access File Systems
Githubredminote105g
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.
Updated 9 months ago (2026-01-02 13:01 UTC)
1
MIT
PC Controller MCP Server
Shell Access File Systems OS Automation
rayss868
A
license
A
quality
B
maintenance
Enables 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.
Updated 11 days ago (2026-09-09 02:53 UTC)
18
1
MIT