Mcp Browser-Automatisierung

Erstellt vonalgoniusalgonius

MCP-Browserautomatisierungsserver. Stellt Browsersteuerungswerkzeuge externen KI-Systemen über das Model Context Protocol zur Verfügung. Open-Source & sicher.

Browser-Automatisierung

Übersicht

Was ist der Algonius Browser?

Der ### Algonius Browser ist ein Open-Source-Browserautomatisierungsserver, der entwickelt wurde, um Browsersteuerungswerkzeuge über das Model Context Protocol (MCP) für externe KI-Systeme zugänglich zu machen. Dieses innovative Tool ermöglicht es Entwicklern, Browserfunktionen in ihre Anwendungen zu integrieren, was eine nahtlose Automatisierung und Kontrolle von Webinteraktionen ermöglicht.

Funktionen des Algonius Browsers

  • Open Source: Der Algonius Browser ist vollständig Open Source, was Entwicklern den Zugriff, die Modifikation und den Beitrag zum Code ermöglicht.
  • MCP-Integration: Er nutzt das Model Context Protocol, um die Kommunikation zwischen KI-Systemen und Browsersteuerungswerkzeugen zu erleichtern.
  • Sicher: Der Browser wurde mit Blick auf Sicherheit entwickelt und sorgt dafür, dass Automatisierungsaufgaben sicher und effizient ausgeführt werden.
  • Benutzerfreundliche Oberfläche: Der Browser bietet eine einfache Oberfläche, damit Entwickler Automatisierungsaufgaben ohne umfangreiche Einrichtung implementieren können.
  • Community-Unterstützung: Als Open-Source-Projekt hat er eine wachsende Gemeinschaft von Mitwirkenden und Nutzern, die Unterstützung und Verbesserungen bieten.

So verwenden Sie den Algonius Browser

  1. Installation: Beginnen Sie mit dem Klonen des Repositories von GitHub und folgen Sie den Installationsanweisungen in der Dokumentation.
  2. Einrichtung: Konfigurieren Sie die Browsereinstellungen gemäß Ihren Anforderungen. Dies kann die Einrichtung des Model Context Protocol für die Kommunikation mit KI-Systemen umfassen.
  3. Automatisierungsaufgaben: Nutzen Sie die bereitgestellten APIs, um Automatisierungsskripte zu erstellen, die Browseraktionen wie Navigation, Formularübermittlung und Datenaus extraction steuern können.
  4. Testen: Führen Sie Ihre Automatisierungsskripte in einer kontrollierten Umgebung aus, um sicherzustellen, dass sie wie erwartet funktionieren, bevor Sie sie in einer Produktionsumgebung bereitstellen.
  5. Beitragen: Wenn Sie Verbesserungen oder Funktionen hinzufügen möchten, ziehen Sie in Betracht, zum Projekt beizutragen, indem Sie Pull-Requests auf GitHub einreichen.

Häufig gestellte Fragen

F1: Ist der Algonius Browser kostenlos zu verwenden?

A1: Ja, der Algonius Browser ist Open Source und kostenlos unter der Apache-2.0-Lizenz zu verwenden.

F2: Kann ich den Algonius Browser mit bestehenden KI-Systemen integrieren?

A2: Absolut! Der Browser ist so konzipiert, dass er mit externen KI-Systemen über das Model Context Protocol funktioniert, was die Integration unkompliziert macht.

F3: Wo finde ich die Dokumentation für den Algonius Browser?

A3: Die Dokumentation ist im Repository auf GitHub verfügbar und enthält Installationsanweisungen, API-Referenzen und Anwendungsbeispiele.

F4: Wie kann ich Probleme melden oder Funktionen anfordern?

A4: Sie können Probleme melden oder Funktionen anfordern, indem Sie ein Issue im GitHub-Repository eröffnen. Die Community überwacht aktiv das Feedback und reagiert darauf.

F5: Gibt es eine Community für Algonius Browser-Nutzer?

A5: Ja, es gibt eine aktive Community von Nutzern und Mitwirkenden auf GitHub, wo Sie Fragen stellen, Erfahrungen austauschen und an Projekten zusammenarbeiten können.

Detail

<div align="center"> <img src="https://github.com/user-attachments/assets/1b2b1bc0-c7b4-4a45-83f5-4a6161831535" width="600" alt="Algonius Browser Banner" /> </div> <h1 align="center">MCP Browser Automation</h1>

🌐 Overview

Algonius Browser is an open-source MCP (Model Context Protocol) server that provides browser automation capabilities to external AI systems. It exposes a comprehensive set of browser control tools through the MCP protocol, enabling AI assistants and other tools to navigate websites, interact with DOM elements, and extract web content programmatically.

🎯 Key Features

  • MCP Protocol Integration: Standard interface for AI systems to control browser automation
  • Chrome Extension: Background service worker that handles browser interactions
  • Native Messaging: Go-based MCP host that bridges Chrome extension with external tools
  • Comprehensive Tool Set: 5 browser automation tools + 2 MCP resources
  • Type Safety: Full TypeScript implementation with structured error handling
  • Testing Suite: Comprehensive integration tests for all functionality

🛠️ Available MCP Tools

Navigation & Tabs

  • navigate_to: Navigate to URLs with configurable timeout handling
  • manage_tabs: Create, close, and switch between browser tabs

DOM Interaction

  • get_dom_extra_elements: Advanced DOM element extraction with pagination and filtering
  • click_element: Click DOM elements using CSS selectors or text matching
  • set_value: Set values in input fields, textareas, and form elements
  • scroll_page: Scroll pages up or down with customizable distances

📋 Available MCP Resources

Browser State Resources

  • browser://current/state: Complete current browser state in AI-friendly Markdown format

    • Active tab information
    • All browser tabs with URLs, titles, and status
    • Real-time state updates via resource notifications

  • browser://dom/state: Current DOM state overview in Markdown format

    • Page metadata (URL, title, scroll position)
    • First 20 interactive elements
    • Total element count with "more available" indicators
    • Simplified DOM structure
    • Auto-updates when page changes

🚀 Quick Start

1. Install Chrome Extension

From Chrome Web Store (Recommended):

<a href="https://chromewebstore.google.com/detail/algonius-browser-mcp/fmcmnpejjhphnfdaegmdmahkgaccghem" target="_blank"> <img src="https://github.com/user-attachments/assets/4c2c0b5e-8f63-4a8b-9a5e-2d7e8f3c9b1a" alt="Available in the Chrome Web Store" width="248" height="75"> </a>
  1. Click the "Add to Chrome" button on the Chrome Web Store page
  2. Confirm the installation when prompted
  3. The extension will be automatically installed and ready to use

From Source (Development):

### Clone and build
git clone https://github.com/algonius/algonius-browser.git
cd algonius-browser
pnpm install
pnpm build

### Load in Chrome
### 1. Open chrome://extensions/
### 2. Enable "Developer mode"
### 3. Click "Load unpacked"
### 4. Select the 'dist' folder

⚠️ Important: The Chrome extension requires the MCP Host backend service to function properly. Please continue with step 2 to complete the installation.

2. Install MCP Host

One-Click Installation (Recommended):

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/algonius/algonius-browser/master/install-mcp-host.sh | bash

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/algonius/algonius-browser/master/install-mcp-host.ps1 | iex

Manual Installation:

### Download latest release
wget https://github.com/algonius/algonius-browser/releases/latest/download/mcp-host-linux-x86_64.tar.gz

### Extract and install
tar -xzf mcp-host-linux-x86_64.tar.gz
cd mcp-host-linux-x86_64
./install.sh

3. Verify Installation

### Test the MCP host installation
mcp-host-go --version

### The MCP host will be automatically started when needed by the Chrome extension
### You should see the extension icon in your Chrome toolbar

✅ Success: Both components are now installed! The Chrome extension will automatically communicate with the MCP Host when browser automation is requested.

🔧 Integration Examples

Using with AI Assistants

Once installed, AI systems can use the browser automation tools and resources through the MCP protocol:

Tool Usage:

{
  "method": "tools/call",
  "params": {
    "name": "navigate_to",
    "arguments": {
      "url": "https://example.com",
      "timeout": 30000
    }
  }
}

Resource Access:

{
  "method": "resources/read",
  "params": {
    "uri": "browser://current/state"
  }
}

Common Workflows

Web Scraping:

  1. navigate_to → Navigate to target site
  2. Read browser://dom/state → Get page overview
  3. get_dom_extra_elements → Get specific elements with pagination
  4. click_element → Interact with elements
  5. Read browser://dom/state → Extract updated content

Form Automation:

  1. navigate_to → Go to form page
  2. Read browser://dom/state → Identify form elements
  3. set_value → Fill form fields
  4. click_element → Submit form
  5. Read browser://current/state → Verify completion

Multi-Tab Management:

  1. Read browser://current/state → Check current tabs
  2. manage_tabs → Create/switch tabs
  3. navigate_to → Load content in each tab
  4. Read browser://current/state → Monitor all tab states

Page Navigation with Scrolling:

  1. navigate_to → Go to target page
  2. Read browser://dom/state → Get initial page state
  3. scroll_page → Scroll to load more content
  4. get_dom_extra_elements → Extract newly loaded elements

🏗️ Architecture

External AI System
       ↓ (MCP Protocol)
   MCP Host (Go)
       ↓ (Native Messaging)
Chrome Extension
       ↓ (Chrome APIs)
    Browser Tabs

Components

  • MCP Host: Go-based native messaging host that implements MCP protocol
  • Chrome Extension: Background service worker with tool handlers
  • Content Scripts: DOM interaction and data extraction utilities
  • Integration Tests: Comprehensive test suite for all tools

🧪 Development

Build from Source

Prerequisites:

  • Node.js 22.12.0+
  • pnpm 9.15.1+
  • Go 1.21+ (for MCP host)

Build Extension:

pnpm install
pnpm build

Build MCP Host:

cd mcp-host-go
make build

Run Tests:

### Extension tests
pnpm test

### MCP host tests  
cd mcp-host-go
make test

Development Mode

### Extension development
pnpm dev

### MCP host development
cd mcp-host-go
make dev

📊 Supported Platforms

MCP Host:

  • Linux x86_64
  • macOS Intel (x86_64) and Apple Silicon (arm64)
  • Windows x86_64

Chrome Extension:

  • Chrome/Chromium 88+
  • Microsoft Edge 88+

📚 Documentation

Detailed documentation available in the docs/ directory:

🤝 Contributing

We welcome contributions! Check out our CONTRIBUTING.md for guidelines.

Ways to contribute:

  • Report bugs and feature requests
  • Submit pull requests for improvements
  • Add integration tests
  • Improve documentation
  • Share usage examples

🔒 Security

For security vulnerabilities, please create a GitHub Security Advisory rather than opening a public issue.

💬 Community

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

👏 Acknowledgments

Built with these excellent open-source projects:

Made with ❤️ by the Algonius Browser Team

Give us a star 🌟 if this project helps you build better browser automation!

Serverkonfiguration

{
  "mcpServers": {
    "algonius-browser": {
      "command": "start",
      "autoApprove": [
        "click_element",
        "get_dom_extra_elements",
        "manage_tabs",
        "scroll_page",
        "type_value",
        "navigate_to"
      ],
      "disabled": false,
      "timeout": 3600,
      "url": "http://127.0.0.1:9333/sse",
      "type": "sse"
    }
  }
}

Projektinfo

Autor
algonius
Category
Browser-Automatisierung
Erstellt am
Jun 25, 2025
Stern
4
Sprache
TypeScript
Tags
-
Homepage
https://github.com/algonius/algonius-browser