echo-mcp 0.1.2

A powerful MCP server for local system automation and browser control

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 uv echo-mcp

3. Claude Desktop Configuration

To use this with Claude Desktop, the easiest way is to use uvx to run it automatically. Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "echo-mcp": {
      "command": "C:\\YOUR\\PATH\\TO\\uvx.exe",
      "args": [
        "echo-mcp"
      ]
    }
  }
}

Available Tools

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

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, 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.