Windows Operations MCP

A comprehensive Windows system operations MCP server implementing the FastMCP 2.12.3 protocol with full MCPB (MCP Bundle) packaging support.

What's New (October 2025)

• ** MCPB Migration Complete**: Fully migrated from DXT to MCPB packaging
• ** Enhanced Test Coverage**: 16+ test modules with comprehensive coverage
• ** GitHub Actions CI/CD**: Automated builds and testing
• ** Improved Tools**: Enhanced JSON and media metadata tools
• ** Better Error Handling**: Improved command execution and error reporting
• ** PowerShell Build Automation**: One-command package building
• ** Production Ready**: Validated, tested, and ready for deployment

IMPORTANT: MCPB Migration Complete

This repository has been fully migrated from DXT to MCPB (MCP Bundle) standards as of October 2025. All tooling, configuration, and packaging now follows the latest MCPB specifications with FastMCP 2.12.3 compatibility.

Migration Summary

Key Features

MCPB Packaging & Distribution

• Full MCPB compliance with proper manifest structure (v0.2 format)
• Automated AI-generated manifests for optimal configuration
• PowerShell build automation with validation and signing support
• GitHub Actions CI/CD for automated package building
• Comprehensive exclusion patterns for clean repository archiving
• Production-ready packaging validated and tested

Windows System Operations

• Windows Services Management: Start, stop, restart, list services with filtering
• Windows Event Log Tools: Query, export, monitor, and clear event logs
• Windows Performance Monitoring: Real-time performance counters and system metrics
• Windows Permissions Management: File/directory permissions analysis and modification

Core Operations

• PowerShell & CMD Execution: Reliable command execution with output capture and error handling
• File Operations: Create, read, write, move, copy files and directories with comprehensive error handling
• Archive Management: Create/extract ZIP archives with intelligent exclusion patterns
• JSON Tools: Parse, validate, format, and query JSON files with JSONPath support
• Media Metadata: Extract metadata from images, audio, and video files
• System Information: Comprehensive OS, hardware, and environment reporting
• Health Monitoring: Built-in health checks and diagnostic tools

Installation

Option 1: MCPB Package (Recommended)

1. Download the latest release from the GitHub Releases page
2. Drag the .mcpb file to Claude Desktop for automatic installation
3. Follow the configuration prompts to set up your preferences
4. Restart Claude Desktop to complete the installation

Option 2: Manual Installation

# Clone the repository
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
pip install -e .

# Configure for Claude Desktop
# Add to claude_desktop_config.json:
{
  "mcpServers": {
    "windows-operations": {
    "command": "python",
      "args": ["-m", "windows_operations_mcp"],
      "cwd": "src"
    }
  }
}

Development & Building

Prerequisites

# Install MCPB CLI (official toolchain)
npm install -g @anthropic-ai/mcpb

# Install Python dependencies (EXACT VERSIONS)
pip install "fastmcp>=2.12.0,<3.0.0"
pip install -r requirements.txt

Repository Structure

windows-operations-mcp/
 mcpb/                          # MCPB configuration and manifest
    manifest.json              # AI-generated runtime configuration
    assets/                    # Icons, screenshots
 src/                           # Python source code
    windows_operations_mcp/    # Main Python package
        __init__.py
        server.py              # Main server entry point
        tools/                 # Tool modules
 scripts/                       # Build and utility scripts
    build-mcp-package.ps1     # MCPB package builder
 docs/                          # Documentation
 requirements.txt               # Python dependencies
 README.md                      # This file

Building MCPB Packages

# Show help and available options
.\scripts\build-mcp-package.ps1 -Help

# Build and sign the package (default behavior)
.\scripts\build-mcp-package.ps1

# Build without signing (for development/testing)
.\scripts\build-mcp-package.ps1 -NoSign

# Specify custom output directory
.\scripts\build-mcp-package.ps1 -OutputDir "C:\builds"

Local Development Workflow

# 1. AI-generate manifest.json (place in mcpb/manifest.json)
# ENSURE: fastmcp>=2.12.0 in requirements.txt
# ENSURE: cwd: "src" and PYTHONPATH: "src" in mcp_config

# 2. Validate manifest
cd mcpb
mcpb validate manifest.json

# 3. Build MCPB package
mcpb pack . ../dist/package.mcpb

# 4. Te…