convez.ai
MCP ServerAutomaçãoIntermediário
mukul975

MCP Windows Automation Server

mukul975/mcp-windows-automation

Automação Windows nativa com IA via Model Context Protocol

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que transforma seu PC Windows em um hub de automação controlado por IA (Claude, ChatGPT e outros). Oferece 200+ ferramentas para controlar aplicativos, gerenciar processos, automação de arquivos, web scraping e integração com Microsoft Office através de comandos em linguagem natural.

Instalação

$npx convez-ai mukul975/mcp-windows-automation

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
62
Forks
17
Acompanhando
1
Saúde
57%
Último commit
há 5 meses
Versão
—
Issues abertas
5
Contribuidores
1

Casos de uso

  • Automação de tarefas repetitivas no Windows via assistentes IA
  • Controle de aplicativos Office (Excel, Word, PowerPoint) por comandos naturais
  • Gerenciamento de processos, arquivos e registro do sistema com segurança
  • Web scraping e preenchimento de formulários automatizado
  • Captura de tela, OCR e processamento de imagens integrado

Veredito

Ferramenta robusta e bem-mantida para automação Windows profissional via IA. Suporta integração nativa com Claude Desktop e oferece arquitetura extensível. Recomendado para usuários que já dominam Python e buscam automação desktop sophisticada com IA.

README

A tradução para o português deste README ainda está na fila.

🚀 MCP Windows Server - AI-Powered Windows Automation

License: MIT Python 3.10+ Platform: Windows PyPI version AI Ready

Transform your Windows PC into an intelligent automation hub controlled by AI assistants like Claude, ChatGPT, and more.

🔍 Overview

MCP Windows Server is an AI-native automation framework that enables AI assistants to control Windows systems through natural language commands. Built on the Model Context Protocol (MCP), it provides secure, comprehensive system-level automation capabilities.

🤖 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 system services. Our server implements this protocol for Windows, making AI assistants powerful desktop automation agents.

  • 🔐 Secure System Access - Controlled command execution with safety filters
  • 🧠 AI Agent Compatible - Works with Claude, ChatGPT, and other AI assistants
  • 🔄 Real-Time Communication - Instant bidirectional AI ↔️ System interaction
  • 🔧 Plugin Architecture - Extensible framework for custom automation

🚀 Quick Start

Installation

# Install from PyPI
pip install mcp-windows-server

# Or install from source
git clone https://github.com/mukul975/mcp-windows-automation.git
cd mcp-windows-server
pip install -r requirements.txt

Usage

# Start the MCP server
mcp-windows-server

# Or use the unified server directly
unified-server

Claude Desktop Integration

  1. Install the package: pip install mcp-windows-server
  2. Configure Claude Desktop:
{
  "mcpServers": {
    "mcp-windows-server": {
      "command": "mcp-windows-server",
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}
  1. Restart Claude Desktop and start automating!

🌟 Key Features

  • ✅ 200+ Automation Tools - Comprehensive Windows control
  • 🧠 AI-Context Aware - Understands natural language commands
  • 🔁 Bidirectional Communication - Real-time AI ↔️ System interaction
  • ⚙️ Safe Execution - Built-in command filtering and validation
  • 🧱 Modular Design - Plugin-based architecture
  • 🧪 ML Integration - Machine learning for predictive automation

🧭 Automation Categories

CategoryDescriptionExamples
🖥️ System ControlProcess, registry, services managementKill processes, manage services, registry edits
📁 File OperationsFile system automationCopy, move, search, backup files
🌐 Web AutomationBrowser control and web scrapingForm filling, data extraction, navigation
🖼️ Image ProcessingScreenshot and image manipulationOCR, image editing, screen capture
📊 Data AnalysisML training and data processingModel training, data visualization
🏢 Office IntegrationMicrosoft Office automationExcel reports, Word documents, PowerPoint
🔒 SecuritySystem security and monitoringFirewall rules, security scans, monitoring
🌐 NetworkNetwork configuration and monitoringWiFi management, network diagnostics

🛠️ Example Commands

Once integrated with Claude Desktop, you can use natural language:

"Take a screenshot and save it as desktop.png"
"Get my system information"
"List all running processes"
"Create a backup of my Documents folder"
"Check my network connection status"
"Open Calculator application"

📁 Project Structure

mcp-windows-server/
├── mcp_windows_automation/     # Main package
│   └── __init__.py
├── unified_server.py           # Core MCP server
├── office_mcp_server.py        # Office integration
├── config/                     # Configuration templates
├── docs/                       # Documentation
├── examples/                   # Usage examples
├── requirements.txt            # Dependencies
└── README.md                   # This file

🔧 Configuration

Environment Variables

# Optional MySQL database integration
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database
MYSQL_HOST=localhost
MYSQL_PORT=3306

# Python configuration
PYTHONPATH=/path/to/mcp-windows-server
PYTHONUNBUFFERED=1

Advanced Configuration

For advanced setups, copy the configuration template:

cp config/claude_desktop_config.template.json config/claude_desktop_config.json
# Edit with your specific paths and credentials

🧪 Development

Running from Source

git clone https://github.com/Mahipal/mcp-windows-server.git
cd mcp-windows-server
pip install -r requirements.txt
python unified_server.py

Building Package

python -m build
pip install dist/mcp_windows_server-*.whl

🔒 Security

  • Command Filtering: Dangerous commands are blocked by default
  • Safe Execution: All operations run in controlled environment
  • No Credential Storage: Sensitive data excluded from package
  • Template-Based Config: Only safe configuration templates included

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

📬 Contact

🙏 Acknowledgments

  • Anthropic for the Model Context Protocol
  • Claude for AI assistant integration
  • The open-source community for inspiration and contributions

"Automate Everything. With AI." 🧠💻

Made with ❤️ for the AI automation community

Ver o original no GitHub

Bom para

Relacionados