# windows-operations-mcp
## 基本信息
- Slug: `sandraschi-windows-operations-mcp`
- Source: modelscope
- Publisher: @sandraschi/windows-operations-mcp
- Categories: os-automation / shell-access / file-systems
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@sandraschi/windows-operations-mcp
## 简介
暂无描述。
## 安装提示

```bash
# 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" } } }
```

## MCP Server 详情

# Windows Operations MCP

[![FastMCP](https://img.shields.io/badge/FastMCP-2.12.3-blue)](https://github.com/jlowin/fastmcp)
[![Python](https://img.shields.io/badge/Python-3.9%2B-blue)](https://www.python.org/)
[![MCPB](https://img.shields.io/badge/MCPB-v0.2-green)](https://modelcontextprotocol.io)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Status](https://img.shields.io/badge/Status-Production%20Ready-green)](REPOSITORY_STATUS_REPORT.md)

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

| Component | Old (DXT) | New (MCPB) | Status |
|-----------|-----------|------------|--------|
| **CLI Tool** | `dxt` commands | `mcpb` commands |  Migrated |
| **Config File** | `dxt.json` | `mcpb.json` |  Migrated |
| **Manifest** | `dxt_manifest.json` | `mcpb/manifest.json` |  Migrated |
| **Package Format** | `.dxt` packages | `.mcpb` packages |  Migrated |
| **Documentation** | DXT guides | MCPB guides |  Migrated |
| **Build Scripts** | Manual build | PowerShell automation |  Migrated |
| **CI/CD** | None | GitHub Actions |  Added |

##  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](https://github.com/sandraschi/windows-operations-mcp/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

```bash
# 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

```bash
# 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

```powershell
# 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

```bash
# 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…