Skip to main content
Glama
Windows Process Bridge MCP

Windows Process Bridge MCP

by nauiter

Windows Process Bridge MCP

A local MCP (Model Context Protocol) server that gives AI clients like Claude Desktop real, read-first access to Windows processes, services, resources and PowerShell, without controlling the mouse or screen.

Most AI desktop assistants either run in a sandboxed cloud VM (no real OS access) or fall back to screen/mouse control to check something as simple as "is this app running". This server exposes that information directly, as proper tool calls, with a safety-first design: read operations are unrestricted, state-changing operations require an explicit confirm=True plus the client's own permission prompt, and arbitrary PowerShell is blocked by an allowlist of read-only verbs (Get-, Measure-, Select-, Sort-, Where-, Format-, Group-). Any attempt to run Stop-, Remove-, Set-, Start-, Invoke-, New-, or to pipe into a file/exe, is rejected before it ever executes.

🧰 What it gives your AI client

  • list_processes / check_process(name) / open_task_manager β€” basic process visibility, no mouse needed

  • run_powershell(cmd) / run_powershell_readonly(cmd) β€” any read-only PowerShell one-liner or pipeline, allowlist-enforced

  • get_process_stats, list_processes_grouped, system_snapshot, gpu_status β€” CPU/RAM/VRAM/disk at a glance, via psutil and nvidia-smi

  • start_process(target) / kill_process(pid, name, confirm=True) β€” launch or terminate, with destructive actions gated behind an explicit confirm flag

  • list_services, startup_apps, disk_usage β€” Windows services, startup programs and largest folders

Related MCP server: MachineProfile MCP

πŸš€ Tech Stack

  • Python 3.11+

  • mcp (official Model Context Protocol SDK, FastMCP)

  • psutil for cross-process stats

  • Stdlib subprocess for tasklist/taskkill/powershell/nvidia-smi

πŸ› οΈ Installation & Local Development

Prerequisites

  • Windows 10/11

  • Python 3.11+

Steps

git clone <repository-url>
cd win-process-bridge-mcp

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

python server.py   # runs as a stdio MCP server, waiting for a client

Register it in Claude Desktop

Edit claude_desktop_config.json (Settings β†’ Developer β†’ Edit Config) and add:

{
  "mcpServers": {
    "win-process-bridge": {
      "command": "C:\\path\\to\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\win-process-bridge-mcp\\server.py"]
    }
  }
}

Restart Claude Desktop completely (quit from the system tray, not just close the window) for the new MCP server to load. On first use of any tool, the client shows its own permission prompt before running anything.

πŸ“„ Project Structure

server.py            All 13 tools in a single FastMCP server (stdio transport)
requirements.txt      mcp + psutil

πŸ”’ Security Model

Aspect

Design

Read operations

Unrestricted (list_processes, system_snapshot, gpu_status, etc.)

PowerShell

Allowlist of read-only verbs only; blocklist regex as a second layer

Destructive ops

kill_process requires confirm=True in addition to the client's own permission UI

Scope

Only processes/services explicitly named by the calling tool call; no background daemons, no network listener

Transport

stdio only β€” runs as a child process of the AI client, no open port

This project does not attempt to sandbox PowerShell execution itself (no AppContainer, no restricted token) β€” the allowlist is a cooperative guard against accidental or careless use by an AI client that is already supposed to behave, not a security boundary against a malicious one. Don't expose this server to an untrusted caller.

License

MIT. See LICENSE.


Β© 2026 Nauiter Master | AI Strategist, Digital Artist & Automation

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Exposes Windows system information and control tools including hardware stats, network details, and process monitoring. It enables AI applications to retrieve real-time data about CPU, memory, drives, and active system processes.
      12
      GPL 3.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to retrieve structured information about the local Windows machine, including system specifications, resource health, developer tools, and AI environment, all through a secure, read-only interface.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables guarded, local-first perception and interaction with Windows desktops through UI Automation, screenshots, and bounded mouse/keyboard actions with deterministic verification. It prioritizes semantic/read-only inspection and excludes arbitrary shell execution or destructive system operations.
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to safely query and manage Windows services, processes, event logs, and system information, with write actions disabled by default.
      6
      MIT