Skip to content

๐Ÿš€ AI-Powered Windows Automation Server using Model Context Protocol (MCP) | Control Windows apps, automate tasks, and manage systems through natural language commands with Claude, ChatGPT & other AI assistants | 80+ automation tools

License

Notifications You must be signed in to change notification settings

mukul975/mcp-windows-automation

Repository files navigation

๐Ÿš€ 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: [email protected]

GitHub: mukul975

โ€œAutomate Everything. With AI.โ€ ๐Ÿง ๐Ÿ’ป

About

๐Ÿš€ AI-Powered Windows Automation Server using Model Context Protocol (MCP) | Control Windows apps, automate tasks, and manage systems through natural language commands with Claude, ChatGPT & other AI assistants | 80+ automation tools

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published