AETHER 01

AETHER_01 - это передовой MCP (Model Context Protocol) сервер, предназначенный для расширенного и глубокого взаимодействия с операционной системой Windows. Он предоставляет беспрецедентный уровень контроля и автоматизации, позволяя AI-агентам выполнять широкий спектр сложных задач: от детального системного администрирования и управления файлами, процессами, сетью, реестром до тонкой настройки пользовательского интерфейса. Разработанный для максимальной гибкости и мощности, AETHER_01 открывает новые возможности для интеллектуальной автоматизации и управления вашим ПК.

---

✨ Key Features

• Comprehensive File System Control: Read, write, create, delete, move, copy, and rename files and folders. Get detailed file information.
• Process & Application Management: Launch, close, terminate, suspend, and resume processes. Get detailed information about running processes. Execute command-line and PowerShell commands.
• Flexible Network Operations: Download files, manage network adapters (enable/disable, static IP), get network connection info, ping hosts, flush DNS.
• Windows Registry Interaction: Read, write, and delete registry keys and values.
• Advanced System Administration: Get detailed system info (OS, CPU, RAM, GPU, disks), installed software, running services, event logs, scheduled tasks, user accounts, startup programs. Manage services (start, stop, restart). Create and delete scheduled tasks. Manage power schemes and firewall profiles.
• Graphical User Interface (GUI) Automation: Mouse movement, clicks, scrolling, dragging, text input, hotkey presses. Take screenshots. Locate images on screen. Clipboard operations. Display dialog boxes (alert, confirm, prompt).
• Window Management: Get lists of all open windows, active window info. Activate and close windows by title.
• Security Functions: Encrypt and decrypt files with EFS. Set file permissions. Execute commands with administrator privileges.
• User Session Management: Lock workstation, shut down, restart, and log off users.
• Audio Control: Set and get system master volume.

---

📦 Installation

Prerequisites

• Python 3.10+: Ensure a compatible Python version is installed.
• pip: Python package installer.

Steps

1. Clone the repository (or download project files):

   git clone https://github.com/YourUsername/shadow-core-windows-mcp.git # Replace YourUsername
   cd shadow-core-windows-mcp
   

   If you don't have a repository yet, you can simply create a folder and copy fastmcp_server.py and requirements.txt into it.

2. Install dependencies: Navigate to the project directory and install all required libraries using requirements.txt:

   pip install -r requirements.txt
   

---

▶️ Running the Server

To start the AETHER_01 Windows Control Server, execute the fastmcp_server.py script:

python fastmcp_server.py

The server will be running on http://127.0.0.1:5000.

---

🔧 MCP Client Configuration

To integrate with an MCP client (e.g., Gemini CLI, Claude Desktop), configure it to connect to http://127.0.0.1:5000. Here's an example for Gemini CLI:

// %USERPROFILE%/.gemini/settings.json
{
  "mcpServers": {
    "aether-01-windows-mcp": {
      "command": "python",
      "args": [
        "<path_to_your_project>/fastmcp_server.py"
      ],
      "host": "127.0.0.1",
      "port": 5000
    }
  }
}

Replace <path_to_your_project> with the actual path to your directory containing fastmcp_server.py.

---

📜 Available MCP Tools

The AETHER_01 Windows Control Server provides a comprehensive set of tools, allowing fine-grained control over the Windows operating system. Each tool is implemented as a Python function decorated with @mcp.tool.

Key categories of tools include:

• File System & Directory Management: Tools for reading, writing, moving, copying, deleting, and getting information about files and folders.
• Process & Application Control: Functions to list, start, stop, suspend, and resume processes, as well as launching and closing applications.
• Network Operations: Tools for downloading files, managing network adapters, querying network connections, and basic network diagnostics like ping and DNS flushing.
• Windows Registry Access: Capabilities to read, write, and delete entries in the Windows registry.
• System & OS Administration: Extensive tools for gathering system information, managing installed software, Windows services, event logs, scheduled tasks, user accounts, and power settings.
• Graphical User Interface (GUI) Automation: Comprehensive functions for simulating mouse and keyboard input, taking screenshots, image recognition, and interacting with the clipboard and dialog boxes.
• Window Management: Tools to enumerate, activate, and close application windows.
• Security & System Integrity: Functions for file encryption/decryption, setting file permissions, and executing commands with elevated privileges.
• User Session Control: Operations to lock the workstation, shut down, restart, or log off the current user.
• Audio Control: Tools to manage the system's master volume.

For a full list of all available tools, their parameters, and detailed descriptions, please refer to the fastmcp_server.py source code.

---

⚠️ Security Note

This MCP server wields exceptionally broad capabilities for low-level interaction with your Windows operating system. It directly calls system utilities and PowerShell commands, some of which execute with shell=True or require administrative privileges.

It is critically important to use this server with extreme caution. Do not run it in untrusted environments, and ensure you fully understand the implications of each tool before allowing an AI agent to utilize them. Improper or malicious use can lead to data loss, system corruption, or privacy breaches.

• Always verify the requests you send to the agent.
• Consider running in an isolated environment (virtual machine) if critical.
• Be cautious with tools that modify the system (e.g., file operations, registry, processes, network settings) or require administrator rights (run_as_admin).

---

📄 License

This project is licensed under the MIT License.

---

🙏 Acknowledgements

This project leverages and builds upon the following excellent libraries:

• fastmcp
• PyAutoGUI
• mss
• pyperclip
• PyGetWindow
• requests

Huge thanks to the developers and communities of these projects for their contributions to open-source.