Use This MCP server To

Automate Windows GUI tasks using AutoIt functions Capture screenshots of desktop or specific windows Read and manipulate files and directories on Windows Execute complex desktop workflows via LLM commands Integrate Windows automation into AI-enhanced workflows Use prompt templates for common automation scenarios Control Windows applications programmatically through MCP Monitor and interact with desktop environment in real-time

README

MCP Windows Desktop Automation

A Model Context Protocol (MCP) server for Windows desktop automation using AutoIt.

Overview

This project provides a TypeScript MCP server that wraps the node-autoit-koffi package, allowing LLM applications to automate Windows desktop tasks through the MCP protocol.

The server exposes:

Tools: All AutoIt functions as MCP tools
Resources: File access and screenshot capabilities
Prompts: Templates for common automation tasks

Features

Full wrapping of all AutoIt functions as MCP tools
Support for both stdio and WebSocket transports
File access resources for reading files and directories
Screenshot resources for capturing the screen or specific windows
Prompt templates for common automation tasks
Strict TypeScript typing throughout

Installation

# Clone the repository
git clone https://github.com/yourusername/mcp-windows-desktop-automation.git
cd mcp-windows-desktop-automation

# Install dependencies
npm install

# Build the project
npm run build

Usage

Starting the Server

# Start with stdio transport (default)
npm start

# Start with WebSocket transport
npm start -- --transport=websocket --port=3000

# Enable verbose logging
npm start -- --verbose

Command Line Options

--transport=stdio|websocket: Specify the transport protocol (default: stdio)
--port=<number>: Specify the port for WebSocket transport (default: 3000)
--verbose: Enable verbose logging

Tools

The server provides tools for:

Mouse operations: Move, click, drag, etc.
Keyboard operations: Send keystrokes, clipboard operations, etc.
Window management: Find, activate, close, resize windows, etc.
Control manipulation: Interact with UI controls, buttons, text fields, etc.
Process management: Start, stop, and monitor processes
System operations: Shutdown, sleep, etc.

Resources

The server provides resources for:

File access: Read files and list directories
Screenshots: Capture the screen or specific windows

Prompts

The server provides prompt templates for:

Window interaction: Find and interact with windows
Form filling: Automate form filling tasks
Automation tasks: Create scripts for repetitive tasks
Monitoring: Wait for specific conditions

Development

# Run in development mode
npm run dev

# Lint the code
npm run lint

# Run tests
npm run test

License

MIT

mcp-windows-desktop-automation FAQ

How do I install the MCP Windows Desktop Automation server?

Clone the GitHub repository, then follow the TypeScript build and run instructions provided in the README to start the server.

What transport protocols does this MCP server support?

It supports both stdio and WebSocket transports for flexible integration.

Can I access files and directories on Windows through this server?

Yes, it exposes file access resources allowing reading and manipulation of files and directories.

How does this server expose AutoIt functions?

All AutoIt functions are wrapped and exposed as MCP tools, enabling LLMs to invoke them directly.

Are there any built-in prompts or templates?

Yes, the server includes prompt templates for common Windows automation tasks to simplify usage.

Is this server typed for TypeScript?

Yes, it uses strict TypeScript typing for better developer experience and reliability.

Can this server capture screenshots?

Yes, it provides resources to capture screenshots of the entire screen or specific windows.

What is node-autoit-koffi?

It is the underlying Node.js package that interfaces with AutoIt, enabling Windows automation from JavaScript/TypeScript environments.