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.1.1-py3-none-any.whl (8.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: automata_mcp-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 8.5 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.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 68157034a544de9ab0531dfb955feb06d002cd49c16495b3d5be0f53da855abb
MD5 4f23c659567f4d479fa35ac6f8d5b2fb
BLAKE2b-256 48dbd5555f50c2254d543dc7c8e260a4233dbf3c9a0caffc76a0a77f1d220b4e

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