Skip to main content

🚀 MCP Windows Automation Server - AI-Powered Windows Control Suite

License Python Version Platform AI Ready
Transform your Windows PC into an intelligent automation hub controlled by AI assistants.

🔍 Overview

MCP Windows Automation Server is an AI-native automation framework that allows AI assistants like ChatGPT, Claude, LocalAI, and others to automate over 200 Windows tasks through natural language commands. It uses Model Context Protocol (MCP) to provide deep system-level control securely.

🤖 What is Model Context Protocol (MCP)?

MCP is an open protocol by Anthropic that allows AI models to interact safely with local tools, APIs, and OS services. The MCP Server implements this for Windows, making AI assistants powerful desktop controllers.

  • 🔐 Secure OS Command Access
  • 🧠 AI Agent Compatibility
  • 🔄 Real-Time Communication
  • 🔧 Plugin-Ready Framework

🌟 Key Features

  • ✅ 209+ Tools for Automation
  • 🧠 AI-Context Awareness
  • 🔁 Bi-directional AI ↔️ System
  • ⚙️ Sandbox Execution Mode
  • 🧱 Modular Plugin Design
  • 🧪 ML Engine for Prediction

🧭 Tool Categories

  • 🖥️ System Control: Processes, registry, services
  • 🧰 UI Automation: Mouse/keyboard emulation, OCR
  • 🎵 Media: Spotify, YouTube, VLC automation
  • 🌍 Web Automation: Chrome DevTools, form automation
  • 📂 File System: Sync, backups, file watchers
  • 📑 Office: Excel, Word, PowerPoint, Outlook
  • 🖼️ Vision: OCR, screenshot utilities
  • 🌐 Networking: WiFi, DNS, firewall, hotspot tools

🧠 AI/ML Prediction Engine

The ML engine observes system usage and user behavior, training predictive models for:

  • 🔮 Action Prediction
  • 📊 Resource Forecasting
  • 🎯 Workflow Optimization
  • 🛠️ Performance Tuning

⚡ Use Cases

  • 📈 Automate business reports, emails, monitoring
  • 🎧 Create playlists, record media actions
  • 💻 Developer setup automation
  • 🔧 Admin tasks like SFC, event logs, service checks

🚀 Installation

git clone https://github.com/mukul975/mcp-windows-automation.git
cd mcp-windows-automation
pip install -r requirements.txt

▶️ Start Server

python src/unified_server.py

🌐 Web Automation

  1. Download ChromeDriver
  2. Add to PATH or project root

🧠 ML Monitoring

python -c "from src.unified_server import start_ml_monitoring; start_ml_monitoring()"

🧪 Sample Tool Calls

{
  "tool": "spotify_play_favorite_song"
}

{ "tool": "take_screenshot", "parameters": { "filename": "screen.png" } }

📁 Project Structure

├── src/
│   ├── unified_server.py
│   ├── advanced_automation_server.py
│   ├── mcp_gui.py
├── config/
├── docs/
├── examples/
├── tests/
└── README.md

🧪 Testing

python -m pytest tests/

🤝 Contributing

  1. Fork and clone
  2. Create feature branch
  3. Add tests
  4. Run tests
  5. Submit PR

📜 License

MIT License — See LICENSE file

📬 Contact

Email: mukuljangra5@gmail.com

GitHub: mukul975

“Automate Everything. With AI.” 🧠💻

Metadata

Release files for mcp-windows-server 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-windows-server 1.0.1
File Size Uploaded Provenance
mcp_windows_server-1.0.1.tar.gz 141.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-windows-server 1.0.1
File Interpreter ABI Platform
mcp_windows_server-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 257.7 kB

Release files / mcp_windows_server-1.0.1.tar.gz

Download URL mcp_windows_server-1.0.1.tar.gz
Size 141.3 kB
Tags Source
SHA-256 checksum
How to use checksums
b8c9ff8028864a981342b3f76b80eafe7a919e29eba168f80168ac2e761563bb
BLAKE2b-256 checksum
How to use checksums
84a68a390f8c055d08769b8102d43f4044b8a5546f3e59163858b58eb7d7d2d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.10

Release files / mcp_windows_server-1.0.1-py3-none-any.whl

Download URL mcp_windows_server-1.0.1-py3-none-any.whl
Size 116.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7da809770f8ff5879512e9f619dfdd3b51a61f0511fb34e653bb5dd5cd4b1a05
BLAKE2b-256 checksum
How to use checksums
1f40fb8ea6d805d8b9d2e719f2c529afeb0810af034854023bf1402db92f7715
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.10

Security for mcp-windows-server 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page