MCP Windows Desktop Automation

🚀 Windows 桌面自動化 MCP 服務器

本項目是一個藉助 AutoIt 實現的 Windows 桌面自動化 Model Context Protocol (MCP) 服務器，能讓 LLM 應用程序通過 MCP 協議自動化處理 Windows 桌面任務，功能強大且實用。

🚀 快速開始

本項目提供了一個 TypeScript MCP 服務器，它封裝了 node-autoit-koffi 包，允許 LLM 應用程序通過 MCP 協議自動化 Windows 桌面任務。

✨ 主要特性

• 完整封裝所有 AutoIt 函數作為 MCP 工具，功能全面。
• 支持 stdio 和 WebSocket 傳輸協議，使用靈活。
• 具備文件訪問資源，可用於讀取文件和目錄。
• 擁有截圖資源，能捕獲屏幕或特定窗口。
• 提供常見自動化任務的提示模板，方便快捷。
• 嚴格使用 TypeScript 類型，保證代碼質量。

📦 安裝指南

# 克隆倉庫
git clone https://github.com/yourusername/mcp-windows-desktop-automation.git
cd mcp-windows-desktop-automation

# 安裝依賴
npm install

# 構建項目
npm run build

💻 使用示例

啟動服務器

# 通過 stdio 傳輸啟動（默認）
npm start

# 通過 WebSocket 傳輸啟動
npm start -- --transport=websocket --port=3000

# 啟用詳細日誌記錄
npm start -- --verbose

命令行選項

• --transport=stdio|websocket：指定傳輸協議（默認：stdio）
• --port=<number>：指定 WebSocket 傳輸的端口（默認：3000）
• --verbose：啟用詳細日誌記錄

📚 詳細文檔

工具

服務器提供以下工具用於：

• 鼠標操作：移動、點擊、拖動等。
• 鍵盤操作：發送鍵擊，剪貼板操作等。
• 窗口管理：查找、激活、關閉、調整窗口大小等。
• 控件操作：與 UI 控件交互，按鈕、文本框等。
• 進程管理：啟動、停止和監控進程。
• 系統操作：關機、睡眠等。

資源

服務器提供以下資源用於：

• 文件訪問：讀取文件和列出目錄。
• 截圖：捕獲屏幕或特定窗口。

提示

服務器提供以下提示模板用於：

• 窗口交互：查找並交互窗口。
• 表單填寫：自動化表單填寫任務。
• 自動化任務：創建重複性任務腳本。
• 監控：等待特定條件。

開發

# 以開發模式運行
npm run dev

# 檢查代碼風格
npm run lint

# 運行測試
npm run test

📄 許可證

本項目採用 MIT 許可證。