https://github.com/ifokeev/airbrowser-mcp
Undetectable Chrome for AI agents, web scraping, and automation. REST API + MCP server + VNC debugging.
https://github.com/ifokeev/airbrowser-mcp
ai-agents browser-automation chrome mcp selenium seleniumbase web-scraping
Last synced: 30 days ago
JSON representation
Undetectable Chrome for AI agents, web scraping, and automation. REST API + MCP server + VNC debugging.
- Host: GitHub
- URL: https://github.com/ifokeev/airbrowser-mcp
- Owner: ifokeev
- License: other
- Created: 2025-12-23T17:10:27.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-01-04T13:37:23.000Z (about 1 month ago)
- Last Synced: 2026-01-06T23:15:41.238Z (about 1 month ago)
- Topics: ai-agents, browser-automation, chrome, mcp, selenium, seleniumbase, web-scraping
- Language: Python
- Homepage: https://ifokeev.github.io/airbrowser-mcp/
- Size: 1.13 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Airbrowser
[](https://github.com/ifokeev/airbrowser-mcp/actions/workflows/ci.yml)
[](https://pypi.org/project/airbrowser-client/)
[](https://www.npmjs.com/package/airbrowser-client)
[](LICENSE)
[](https://discord.gg/dP9PbTPHcN)
**Open-source browser automation API with anti-detection** — Undetectable Chrome for AI agents, web scraping, and automation. REST API + MCP server + VNC debugging. Selenium/Playwright alternative that bypasses Cloudflare.
## Quick Start
### Cloud Hosted (no setup)
Use the managed cloud version - no installation required:
**[https://airbrowser.dev](https://airbrowser.dev)**
### Docker (one-liner)
```bash
docker run -d -p 18080:18080 --name airbrowser ghcr.io/ifokeev/airbrowser-mcp:latest
```
### Portable Downloads
Download and run - no Docker knowledge required:
| Platform | Download | Requirements |
|----------|----------|--------------|
| Linux | [airbrowser-linux.tar.gz](https://github.com/ifokeev/airbrowser-mcp/releases/latest/download/airbrowser-linux.tar.gz) | `uidmap` package or Docker |
| macOS | [airbrowser-mac.tar.gz](https://github.com/ifokeev/airbrowser-mcp/releases/latest/download/airbrowser-mac.tar.gz) | Colima, Docker Desktop, or Podman |
| Windows | [airbrowser-windows.zip](https://github.com/ifokeev/airbrowser-mcp/releases/latest/download/airbrowser-windows.zip) | Docker Desktop or Podman |
```bash
# Linux/macOS
tar -xzf airbrowser-*.tar.gz && cd airbrowser-* && ./airbrowser
# Windows: Extract zip and double-click airbrowser.bat
```
### From Source
```bash
git clone https://github.com/ifokeev/airbrowser-mcp.git
cd airbrowser-mcp
docker compose up --build
```
---
Open **http://localhost:18080** - all services available:
| Service | Path |
|---------|------|
| Dashboard | `/` |
| API Docs | `/docs/` |
| REST API | `/api/v1/` |
| MCP Server | `/mcp` |
| VNC Viewer | `/vnc/` |
## Features
- Undetected Chrome (SeleniumBase UC)
- 100+ concurrent browsers
- Persistent profiles & cookies
- Tab management
- Proxy per browser ([DataImpulse](https://dataimpulse.com/?aff=250254) recommended)
- MCP for AI agents
- AI vision tools (optional)
## AI Vision (Recommended)
Enable AI-powered vision tools (`what_is_visible`, `detect_coordinates`) by setting your OpenRouter API key. Without it, these tools won't be available to AI agents.
```bash
# Docker run
docker run -d -p 18080:18080 -e OPENROUTER_API_KEY=sk-or-v1-xxx ghcr.io/ifokeev/airbrowser-mcp:latest
# Docker compose
OPENROUTER_API_KEY=sk-or-v1-xxx docker compose up
```
Get your API key at https://openrouter.ai/
## MCP Client Configuration
Add airbrowser to your AI coding assistant:
Claude Code
```bash
claude mcp add airbrowser --transport http http://localhost:18080/mcp
```
Cursor
Go to `Cursor Settings` → `MCP` → `Add new MCP Server`:
```json
{
"mcpServers": {
"airbrowser": {
"url": "http://localhost:18080/mcp",
"transport": "http"
}
}
}
```
VS Code / Copilot
Add to your MCP settings:
```json
{
"mcpServers": {
"airbrowser": {
"url": "http://localhost:18080/mcp",
"transport": "http"
}
}
}
```
Cline
Follow [Cline MCP guide](https://docs.cline.bot/mcp/configuring-mcp-servers) with:
```json
{
"mcpServers": {
"airbrowser": {
"url": "http://localhost:18080/mcp",
"transport": "http"
}
}
}
```
Windsurf
Follow the [Windsurf MCP guide](https://docs.windsurf.com/windsurf/cascade/mcp) with the config above.
### Test your setup
```
Navigate to https://example.com and take a screenshot
```
Your AI assistant should create a browser, navigate to the URL, and return a screenshot.
## Generated Clients
Auto-generated from OpenAPI spec:
```bash
# Python
pip install airbrowser-client
# TypeScript
npm install airbrowser-client
```
## Docs
- [docs/](docs/) - Full documentation
- [examples/](examples/) - Code samples
## License
[Fair Source](LICENSE) - Free for up to 10 users. Cannot be offered as a hosted service. Commercial license required for larger deployments.