home / mcp / windows mcp server

Windows MCP Server

A comprehensive Model Context Protocol (MCP) server that provides AI models with powerful Windows system management capabilities. This MCP enables AI assistants to interact with Windows systems through a secure, well-structured interface.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "guangxiangdebizi-windows-system-mcp": {
      "url": "http://localhost:3100/sse"
    }
  }
}

You can run and interact with a Windows system MCP server to manage files, processes, system information, registry, services, and network tasks from an AI-assisted workflow. This MCP provides a secure, structured interface so your AI tools can perform common Windows administration tasks directly from your client applications.

How to use

You will connect to the Windows MCP server from your MCP client using the provided server configurations. Start the server locally or remotely, then point your client to the server using either the local stdio command or the HTTP endpoint if you have a remote setup. From your client, send action requests that map to file operations, process management, system information, registry access, service control, and network tasks. Use the same action names you see in examples to perform tasks such as listing directory contents, reading files, listing processes, getting environment variables, pinging hosts, and more.

How to install

Prerequisites you need before installing this Windows MCP server are straightforward. You should have Windows 10 or 11, Node.js 18 or newer, and PowerShell 5.1 or newer installed on your machine.

Step-by-step installation options you can follow exactly as written below.

Option 1. Install from npm (recommended)

Option 1: Install from NPM (Recommended)

npm install -g windows-system-mcp

Option 2: Build from Source

If you prefer building from source, follow these steps exactly as shown.

git clone https://github.com/guangxiangdebizi/windows-system-mcp.git
cd windows-system-mcp

npm install
npm run build

Local Development (Stdio)

To run locally in stdio mode after installation, use the following commands depending on your setup.

# If installed globally
windows-system-mcp

# If built from source
npm start

Development

For development with automatic rebuild on changes, use this command.

npm run dev

SSE Deployment (Supergateway)

If you are deploying behind a Supergateway, you can expose the MCP via SSE. The following shows how to start the SSE gateway when using a global install or building from source.

# If installed globally
npx supergateway --stdio "windows-system-mcp" --port 3100

# If built from source
npm run sse

Configuration

Configure how you connect your client to this MCP server. You can use a local stdio command or an HTTP endpoint. The following configurations illustrate common setups.

Claude Desktop Integration

Use the following configurations to integrate with Claude Desktop or similar clients. The stdio configuration runs the local MCP process, while the SSE/HTTP configuration provides a remote endpoint.

StdIO configuration (local)

{
  "mcpServers": {
    "windows_mcp": {
      "command": "windows-system-mcp",
      "args": []
    }
  }
}

StdIO configuration (built from source)

{
  "mcpServers": {
    "windows_mcp_build": {
      "command": "node",
      "args": ["path/to/windows-system-mcp/build/index.js"]
    }
  }
}

SSE/HTTP configuration

{
  "mcpServers": {
    "windows_mcp_http": {
      "type": "http",
      "url": "http://localhost:3100/sse",
      "args": []
    }
  }
}

Available tools

list_directory

List directory contents with optional recursion and depth to explore a file system.

read_file

Read the contents of a file and return metadata and content.

search_files

Search for files by pattern within a path with recursive option.

find_large_files

Identify files above a specified size threshold across a path.

list_processes

List running processes with sorting and limit options.

get_process_details

Retrieve detailed information for a specific process by name or ID.

kill_process

Terminate a running process by its process ID.

get_system_overview

Returns a high-level view of the system, including OS and hardware summaries.

get_hardware_info

Fetch hardware details such as CPU, memory, disk, and network adapters.

get_environment_vars

Retrieve environment variables with optional filtering.

ping_host

Ping a host to test network reachability.

scan_open_ports

Scan a host for open ports within a specified range.

get_network_adapters

List network adapters and their configurations.