Skip to main content

MCP server for browser automation using Playwright

Project description

Automata MCP

A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright.

Features

  • 🌐 Full browser automation through MCP
  • 🎯 Smart element detection and interaction
  • 📝 Text extraction and form filling
  • 🔍 Web scraping capabilities
  • 🚀 Easy integration with Claude Desktop

Installation

pip install automata-mcp

The package will automatically install Playwright and download the Chromium browser on first run.

Usage with Claude Desktop

Add to your Claude Desktop config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "automata": {
      "command": "automata-mcp"
    }
  }
}

Restart Claude Desktop and the browser automation tools will be available.

Available Tools

  • open_browser - Opens browser and navigates to URL
  • navigate_to - Navigate to a new URL
  • get_actionable_elements - Get list of clickable elements
  • click_element - Click an element
  • type_text - Type into input fields
  • extract_text_from_page - Extract all visible text
  • get_element_text - Get text from specific element
  • scroll_page - Scroll in any direction
  • finish - Close browser and cleanup

Example Prompts for Claude

  • "Open amazon.com and search for wireless headphones"
  • "Go to wikipedia.org and extract the main article text"
  • "Navigate to example.com and click the login button"

Development

git clone https://github.com/yourusername/automata-mcp
cd automata-mcp
pip install -e ".[dev]"

License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

automata_mcp-0.2.1-py3-none-any.whl (20.9 kB view details)

Uploaded Python 3

File details

Details for the file automata_mcp-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: automata_mcp-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 20.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.5

File hashes

Hashes for automata_mcp-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 998ebdc74cf2a2a8d5754e640457fe269820bd2cccba96d7121f2386e0e7a101
MD5 a5ec904a3b63a9a7109fc5b8c88f23ac
BLAKE2b-256 b27fb46b394e6115987a94d97c017eafe149e737c5f12b1a2359171c19f16c33

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page