{"id":30770403,"url":"https://github.com/mukul975/mcp-windows-automation","last_synced_at":"2026-04-16T14:02:47.783Z","repository":{"id":304872062,"uuid":"1020348483","full_name":"mukul975/mcp-windows-automation","owner":"mukul975","description":"🚀 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 \u0026 other AI assistants | 80+ automation tools","archived":false,"fork":false,"pushed_at":"2025-07-15T18:38:44.000Z","size":76,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-16T15:56:39.983Z","etag":null,"topics":["ai-assistant","ai-automation","ai-tools","anthropic-claude","artificial-intelligence","automation-framework","chatgpt-integration","claude-desktop","computer-vision","mcp","model-context-protocol","python-automation","screen-automation","selenium-webdriver","spotify-automation","system-automation","web-automation","windows-automation","windows-control","windows-scripting"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mukul975.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-15T18:16:18.000Z","updated_at":"2025-07-15T18:38:47.000Z","dependencies_parsed_at":"2025-07-16T22:01:22.479Z","dependency_job_id":"93dead7d-85cf-4ec9-8287-bccce7581720","html_url":"https://github.com/mukul975/mcp-windows-automation","commit_stats":null,"previous_names":["mukul975/mcp-windows-automation"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/mukul975/mcp-windows-automation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mukul975%2Fmcp-windows-automation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mukul975%2Fmcp-windows-automation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mukul975%2Fmcp-windows-automation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mukul975%2Fmcp-windows-automation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mukul975","download_url":"https://codeload.github.com/mukul975/mcp-windows-automation/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mukul975%2Fmcp-windows-automation/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273685604,"owners_count":25149722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-04T02:00:08.968Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assistant","ai-automation","ai-tools","anthropic-claude","artificial-intelligence","automation-framework","chatgpt-integration","claude-desktop","computer-vision","mcp","model-context-protocol","python-automation","screen-automation","selenium-webdriver","spotify-automation","system-automation","web-automation","windows-automation","windows-control","windows-scripting"],"created_at":"2025-09-04T23:04:43.138Z","updated_at":"2026-04-16T14:02:47.768Z","avatar_url":"https://github.com/mukul975.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 MCP Windows Server - AI-Powered Windows Automation\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![Platform: Windows](https://img.shields.io/badge/platform-Windows%2010%2F11-lightgrey.svg)](https://www.microsoft.com/windows)\n[![PyPI version](https://badge.fury.io/py/mcp-windows-server.svg)](https://badge.fury.io/py/mcp-windows-server)\n[![AI Ready](https://img.shields.io/badge/AI-Assistant%20Ready-brightgreen.svg)](https://github.com/Mahipal/mcp-windows-server)\n\n\u003e **Transform your Windows PC into an intelligent automation hub controlled by AI assistants like Claude, ChatGPT, and more.**\n\n## 🔍 Overview\n\n**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.\n\n### 🤖 What is Model Context Protocol (MCP)?\n\nMCP 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.\n\n- 🔐 **Secure System Access** - Controlled command execution with safety filters\n- 🧠 **AI Agent Compatible** - Works with Claude, ChatGPT, and other AI assistants  \n- 🔄 **Real-Time Communication** - Instant bidirectional AI ↔️ System interaction\n- 🔧 **Plugin Architecture** - Extensible framework for custom automation\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Install from PyPI\npip install mcp-windows-server\n\n# Or install from source\ngit clone https://github.com/mukul975/mcp-windows-automation.git\ncd mcp-windows-server\npip install -r requirements.txt\n```\n\n### Usage\n\n```bash\n# Start the MCP server\nmcp-windows-server\n\n# Or use the unified server directly\nunified-server\n```\n\n### Claude Desktop Integration\n\n1. Install the package: `pip install mcp-windows-server`\n2. Configure Claude Desktop:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-windows-server\": {\n      \"command\": \"mcp-windows-server\",\n      \"env\": {\n        \"PYTHONUNBUFFERED\": \"1\"\n      }\n    }\n  }\n}\n```\n\n3. Restart Claude Desktop and start automating!\n\n## 🌟 Key Features\n\n- ✅ **200+ Automation Tools** - Comprehensive Windows control\n- 🧠 **AI-Context Aware** - Understands natural language commands\n- 🔁 **Bidirectional Communication** - Real-time AI ↔️ System interaction\n- ⚙️ **Safe Execution** - Built-in command filtering and validation\n- 🧱 **Modular Design** - Plugin-based architecture\n- 🧪 **ML Integration** - Machine learning for predictive automation\n\n## 🧭 Automation Categories\n\n| Category | Description | Examples |\n|----------|-------------|----------|\n| 🖥️ **System Control** | Process, registry, services management | Kill processes, manage services, registry edits |\n| 📁 **File Operations** | File system automation | Copy, move, search, backup files |\n| 🌐 **Web Automation** | Browser control and web scraping | Form filling, data extraction, navigation |\n| 🖼️ **Image Processing** | Screenshot and image manipulation | OCR, image editing, screen capture |\n| 📊 **Data Analysis** | ML training and data processing | Model training, data visualization |\n| 🏢 **Office Integration** | Microsoft Office automation | Excel reports, Word documents, PowerPoint |\n| 🔒 **Security** | System security and monitoring | Firewall rules, security scans, monitoring |\n| 🌐 **Network** | Network configuration and monitoring | WiFi management, network diagnostics |\n\n## 🛠️ Example Commands\n\nOnce integrated with Claude Desktop, you can use natural language:\n\n```\n\"Take a screenshot and save it as desktop.png\"\n\"Get my system information\"\n\"List all running processes\"\n\"Create a backup of my Documents folder\"\n\"Check my network connection status\"\n\"Open Calculator application\"\n```\n\n## 📁 Project Structure\n\n```\nmcp-windows-server/\n├── mcp_windows_automation/     # Main package\n│   └── __init__.py\n├── unified_server.py           # Core MCP server\n├── office_mcp_server.py        # Office integration\n├── config/                     # Configuration templates\n├── docs/                       # Documentation\n├── examples/                   # Usage examples\n├── requirements.txt            # Dependencies\n└── README.md                   # This file\n```\n\n## 🔧 Configuration\n\n### Environment Variables\n\n```bash\n# Optional MySQL database integration\nMYSQL_USER=your_username\nMYSQL_PASSWORD=your_password\nMYSQL_DATABASE=your_database\nMYSQL_HOST=localhost\nMYSQL_PORT=3306\n\n# Python configuration\nPYTHONPATH=/path/to/mcp-windows-server\nPYTHONUNBUFFERED=1\n```\n\n### Advanced Configuration\n\nFor advanced setups, copy the configuration template:\n\n```bash\ncp config/claude_desktop_config.template.json config/claude_desktop_config.json\n# Edit with your specific paths and credentials\n```\n\n## 🧪 Development\n\n### Running from Source\n\n```bash\ngit clone https://github.com/Mahipal/mcp-windows-server.git\ncd mcp-windows-server\npip install -r requirements.txt\npython unified_server.py\n```\n\n### Building Package\n\n```bash\npython -m build\npip install dist/mcp_windows_server-*.whl\n```\n\n## 🔒 Security\n\n- **Command Filtering**: Dangerous commands are blocked by default\n- **Safe Execution**: All operations run in controlled environment\n- **No Credential Storage**: Sensitive data excluded from package\n- **Template-Based Config**: Only safe configuration templates included\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 📬 Contact\n\n- **Author**: Mahipal\n- **Email**: mukuljangra5@gmail.com\n- **GitHub**: [Mahipal](https://github.com/Mahipal)\n- **PyPI**: [mcp-windows-server](https://pypi.org/project/mcp-windows-server/)\n\n## 🙏 Acknowledgments\n\n- [Anthropic](https://www.anthropic.com/) for the Model Context Protocol\n- [Claude](https://claude.ai/) for AI assistant integration\n- The open-source community for inspiration and contributions\n\n---\n\n\u003e **\"Automate Everything. With AI.\"** 🧠💻\n\n*Made with ❤️ for the AI automation community*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmukul975%2Fmcp-windows-automation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmukul975%2Fmcp-windows-automation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmukul975%2Fmcp-windows-automation/lists"}