Windows Operations MCP

You can run Windows operations as an MCP server that exposes practical tools for managing services, event logs, performance metrics, permissions, and general file and system operations. This MCP server is designed to work with the MCP ecosystem, enabling you to control and monitor Windows system activities from an MCP client with reliable packaging, testing, and deployment support.

How to use

You will run this MCP server as a local process and connect to it from an MCP client. Use the provided tools to manage Windows services, query event logs, monitor performance counters, and analyze or modify permissions. Start the server from your development environment and interact with it through the MCP client’s standard toolset. You can test basic functionality by launching the server module directly and performing common operations such as listing services, querying logs, and retrieving system information.

How to install

git clone https://github.com/sandraschi/windows-operations-mcp.git
cd windows-operations-mcp

# Install Python dependencies
pip install -r requirements.txt

# Install as editable package (optional for development)
pip install -e .

# Configure Claude Desktop to run the MCP server (example)
# Add to claude_desktop_config.json:
{
  "mcpServers": {
    "windows-operations": {
      "command": "python",
      "args": ["-m", "windows_operations_mcp"],
      "cwd": "src"
    }
  }
}

Additional notes

Prerequisites include having Python and, for MCPB-related workflows, Node.js and the MCPB toolchain if you intend to build or package the MCPB distribution. The server can be executed directly with Python for development and testing, and integration into Claude Desktop is demonstrated with a sample configuration.

Configuration

Environment variables and runtime configuration influence how the server behaves. Use the following environment variables to control log output and Python module resolution during development and packaging.

Troubleshooting

If the server fails to start, verify that your Python path includes the source directory and that all dependencies are installed. Check logs for errors related to module imports or permission issues, and ensure the MCPB packaging steps have completed successfully if you are deploying a packaged MCPB artifact.

Testing

Run unit and integration tests to validate tool behavior, and test the MCP packaging workflow if you are distributing the MCPB package. You can also run the server directly to perform basic functional checks against the listed tools.

Available tools

list_windows_services

List Windows services with optional filtering to show status, name, and display name.

start_windows_service

Start a Windows service by name and report status.

stop_windows_service

Stop a Windows service by name and report status.

restart_windows_service

Restart a Windows service by name and confirm successful restart.

query_windows_event_log

Query Windows event logs with filters such as source, level, and time range.

export_windows_event_log

Export selected event logs to a file for archival or analysis.

clear_windows_event_log

Clear event logs with an optional backup to prevent data loss.

monitor_windows_event_log

Real-time monitoring of event log activity with alerts.

get_windows_performance_counters

Query real-time Windows performance counters for CPU, memory, disk IO, and more.

monitor_windows_performance

Monitor performance metrics over time and visualize trends.

get_windows_system_performance

Provide a comprehensive snapshot of system metrics and health indicators.

get_file_permissions

Analyze file and directory permissions and report on accessControl lists.

set_file_permissions

Modify file and directory permissions with validation and safety checks.

analyze_directory_permissions

Bulk analysis of permissions across a directory tree with reporting.

fix_file_permissions

Apply common permission fixes to resolve access issues.

create_archive

Create ZIP archives with intelligent exclusions.

extract_archive

Extract ZIP archives and preserve permissions where applicable.

list_archive

List contents of archives without extraction.

run_powershell_tool

Execute PowerShell commands and capture output and errors.

run_cmd_tool

Execute CMD commands and return results.

read_file

Read files from disk and return content.

write_file

Write content to files with error handling.

get_system_info

Provide OS, hardware, and environment information.

health_check

Run diagnostic checks and report on server health.

get_help

Provide documentation and usage information for tools.