Echo MCP Server

A Model Context Protocol (MCP) server that provides autonomous GUI automation capabilities to LLM clients (like Claude Desktop). This tool allows an AI to interact directly with your computer's screen, mouse, keyboard, and browser.

Features

• Computer Vision & OCR: Extract text from screen regions and find UI elements visually.
• Mouse & Keyboard Control: Perform clicks, typing, hotkeys, and precise movements.
• Window Management: Focus, minimize, maximize, and query open windows.
• System Automation: Manage processes, execute system commands, adjust volume, and check system health.
• Browser Automation: Full web browsing capabilities (Selenium) for navigating, finding elements, extracting text, and clicking.
• File System: Read/write files, list directories, download files.

Setup Instructions

1. Environment Requirements

• Python 3.12 or higher
• Windows (recommended for PyAutoGUI compatibility)

2. Installation

You can install the package directly from PyPI (https://pypi.org/project/echo-mcp/):

pip install echo-mcp

3. Configuration

You can automatically configure your AI apps and IDEs (Google Antigravity, Claude Desktop, Cursor, Windsurf, VS Code / Cline) to use the MCP server by running:

python -m echo_mcp.config

To configure all supported apps automatically without interactive prompts:

python -m echo_mcp.config --all

This setup wizard configures your client settings files (e.g. ~/.gemini/config/mcp_config.json for Antigravity). Restart your app/IDE after configuration for the new tools to take effect.

Available Tools

The server provides a comprehensive suite of tools spanning multiple categories:

AI Computer Control (Anthropic / OpenAI Operator Standard)

• computer: Unified action tool supporting screenshot, mouse_move, left_click, right_click, middle_click, double_click, triple_click, left_click_drag, mouse_down, mouse_up, type (Unicode clipboard paste), key, hotkey, scroll, and cursor_position. Includes an automatic action-observation feedback loop returning updated screenshots.
• Multimodal Screen Perception: High-visibility pointer crosshair rendered on captured screenshots, Windows DPI auto-scaling, and native MCP Image output format.

Mouse & Keyboard

• mouse_click, mouse_double_click, move_mouse, mouse_drag, mouse_scroll, get_mouse_position
• type_text, press_key, hotkey

Screen & Vision

• take_screenshot (native FastMCP Image output with cursor overlay), get_screen_size, get_text_at_coords, find_text_on_screen, click_element

Window & Process Management

• list_all_windows, focus_window, maximize_window, minimize_window, get_window_geometry, close_all_windows_by_title, get_active_window_info
• list_processes, kill_process, get_process_stats, wait_for_process

System Utilities

• system_power, set_volume, get_system_health, get_disk_usage, ping, list_network_interfaces
• launch_application, get_environment_variable, get_clipboard, set_clipboard, wait

File System

• list_directory, read_file_content, write_to_file, delete_file, create_directory, download_file

Browser Automation

• browser_open, browser_close, browser_navigate, browser_get_url, browser_get_title, browser_get_page_source
• browser_find_element, browser_click, browser_fill_form, browser_extract_text
• browser_screenshot, browser_scroll, browser_execute_script, browser_wait_for_element

Security Warning

Giving an LLM control over your mouse and keyboard is powerful but risky. Only run this server with prompts you trust, and never leave the automation unattended while active.