Provides browser automation capabilities for Firefox, allowing AI assistants to navigate, interact with, and extract data from web pages.
Enables browser automation capabilities for GitHub Copilot Chat, allowing it to interact with web pages to perform testing, scraping, and automation tasks.
Allows execution of custom JavaScript in the browser context, enabling complex interactions and data extraction from web pages.
Integrates with Ollama to provide AI-powered screenshot analysis of web pages using Gemma3 models, enabling visual understanding of page content and structure.
Built with TypeScript to provide type-safe browser automation capabilities for AI assistants.
Uses Zod for runtime validation to ensure reliable browser automation commands and responses.
AutoProbeMCP - a browser for your Agent
A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright. This server enables AI assistants to interact with web pages through a standardized interface.
Perfect for web automation, testing, and debugging workflows with AI assistants including:
Chat.fans - Empower AI agents with web interaction capabilities in VS Code
GitHub Copilot Chat - Enhance your development workflow with browser automation
Any MCP-compatible AI assistant - Universal browser automation for AI tools
Features
Multi-browser support: Chromium, Firefox, and WebKit
Comprehensive automation: Navigate, click, type, screenshot, and more
JavaScript execution: Run custom scripts in the browser context
Element interaction: Wait for elements, get text content, and interact with forms
Screenshot capabilities: Capture full pages or viewport screenshots
Type-safe: Built with TypeScript and runtime validation using Zod
Installation
Make sure Playwright browsers are installed:
For system dependencies (Linux):
Usage
VS Code Integration
Configure the MCP server in VS Code by adding to your settings.json
or workspace configuration:
Once configured, Chat.fans agents and GitHub Copilot Chat can use browser automation tools for web testing, scraping, and automation tasks.
Available VS Code Tasks
Build:
Ctrl+Shift+P
→ "Tasks: Run Task" → "build"Development Mode:
Ctrl+Shift+P
→ "Tasks: Run Task" → "dev"Test MCP Server:
Ctrl+Shift+P
→ "Tasks: Run Task" → "test-mcp-server"
Available Tools
launch_browser - Start a new browser instance
navigate - Go to a specific URL
click_element - Click on page elements
type_text - Enter text into form fields
screenshot - Capture page screenshots
get_element_text - Extract text from elements
wait_for_element - Wait for elements to appear/disappear
evaluate_javascript - Run custom JavaScript
get_console_logs - Get browser console logs (log, info, warn, error, debug)
analyze_screenshot - AI-powered screenshot analysis using Gemma3 (requires Ollama)
get_page_info - Get current page information
close_browser - Close the browser instance
scroll - Scroll the page in the specified direction (up/down/left/right)
check_scrollability - Check if the page is scrollable in specific directions
Example: Web Application Testing
Page Scrolling and Navigation
The MCP Browser Server includes comprehensive scrolling tools for navigating long pages and checking scroll capabilities:
Scroll Tool
The scroll
tool allows you to scroll the page in any direction with fine-grained control:
Parameters:
direction
:"up"
,"down"
,"left"
,"right"
(default:"down"
)pixels
: Number of pixels to scroll (default: 100)behavior
:"auto"
or"smooth"
(default:"auto"
)
Scrollability Check Tool
The check_scrollability
tool determines whether a page can be scrolled in specific directions:
Response includes:
Current scroll position
Maximum scroll distance
Whether scrolling is possible in each direction
Detailed position information
AI-Powered Screenshot Analysis
The analyze_screenshot
tool provides AI-powered analysis of web pages using local Gemma3 models via Ollama. This feature can describe what's visible on a page, analyze page structure, and look for specific elements based on context.
Prerequisites
Install Ollama: Download from ollama.ai
Install Gemma3 model:
ollama pull gemma3:4bStart Ollama service:
ollama serve
Usage Examples
Basic Screenshot Analysis
Detailed Structural Analysis
Context-Specific Analysis
Parameters
fullPage (boolean): Capture entire scrollable page vs viewport only
path (string): Optional file path to save the screenshot
pretext (string): Additional context or specific instructions for the AI
model (string): AI model to use (default: "gemma3:4b")
detailed (boolean): Request detailed structural analysis
Supported Models
gemma3:4b
(default, good balance of speed and quality)Any other vision-capable model available in your Ollama installation
Development & Testing
Quick Setup
Development Commands
Testing
The project includes comprehensive tests in the tests/
directory:
Development Helper
Use the development helper for common tasks:
For more details about testing, see tests/README.md.
Project Structure
License
Dual License:
Personal Use: Free for personal, educational, and non-commercial use
Commercial Use: Requires a separate commercial license
See LICENSE for full terms. For commercial licensing inquiries, please contact us.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A Model Context Protocol server that provides browser automation capabilities using Playwright, enabling AI assistants to interact with web pages through a standardized interface.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides browser automation capabilities using Playwright. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.Last updated -328,5484,867MIT License
- -securityAlicense-qualityA Model Context Protocol server that provides browser automation capabilities using Playwright, enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.Last updated -16Apache 2.0
- AsecurityAlicenseAqualityA Model Context Protocol server that provides browser automation capabilities using Playwright, enabling LLMs to interact with web pages, take screenshots, generate test code, scrape web content, and execute JavaScript in real browser environments.Last updated -318,548MIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with web browsers through Playwright, providing automation capabilities for navigation, interaction, and screenshots.Last updated -143