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 Distribution

automata_mcp-0.2.0.tar.gz (11.4 kB view details)

Uploaded Source

Built Distribution

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

automata_mcp-0.2.0-py3-none-any.whl (20.7 kB view details)

Uploaded Python 3

File details

Details for the file automata_mcp-0.2.0.tar.gz.

File metadata

  • Download URL: automata_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 11.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.5

File hashes

Hashes for automata_mcp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 3472584bf1edd7c9432bc83364511c00a32771f6a3fcf574e14cdf1f72e6543b
MD5 548dd25b28392f0cd3ecd8956a2efb88
BLAKE2b-256 c3ad814ca45400a23c0e6e27d1b171da89103af8f39f89549b47249177ac21fd

See more details on using hashes here.

File details

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

File metadata

  • Download URL: automata_mcp-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 20.7 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1aebf0853444e540c3762a8d4216070c3bec113654795134298c8d3c15b6d14c
MD5 5fe3c50e722ad370c6e15e7a9c7d2d3d
BLAKE2b-256 eb65da947c2dfac04b5fcd440cb3ecc7c7dd8ca017d5f32b8b55a8cb4e57d3d9

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