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 URLnavigate_to- Navigate to a new URLget_actionable_elements- Get list of clickable elementsclick_element- Click an elementtype_text- Type into input fieldsextract_text_from_page- Extract all visible textget_element_text- Get text from specific elementscroll_page- Scroll in any directionfinish- 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3472584bf1edd7c9432bc83364511c00a32771f6a3fcf574e14cdf1f72e6543b
|
|
| MD5 |
548dd25b28392f0cd3ecd8956a2efb88
|
|
| BLAKE2b-256 |
c3ad814ca45400a23c0e6e27d1b171da89103af8f39f89549b47249177ac21fd
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1aebf0853444e540c3762a8d4216070c3bec113654795134298c8d3c15b6d14c
|
|
| MD5 |
5fe3c50e722ad370c6e15e7a9c7d2d3d
|
|
| BLAKE2b-256 |
eb65da947c2dfac04b5fcd440cb3ecc7c7dd8ca017d5f32b8b55a8cb4e57d3d9
|