Groundlane

English | 繁體中文

Die vertrauenswürdige Webzugriffsschicht für KI-Agenten.

Groundlane ist ein Open-Source-, anbieterneutraler Remote-MCP-Server, der KI-Agenten kontrollierten Zugriff auf das öffentliche Web ermöglicht. Er bietet eine stabile Schnittstelle für Suche, Abruf und deterministische Extraktion, leitet die Suche an austauschbare Anbieter weiter und stuft schwierige Markdown-Lesevorgänge über einen optionalen Jina Reader hoch, bevor er einen isolierten lokalen oder Browserless-Browser verwendet.

[!IMPORTANT] Groundlane befindet sich in einer frühen Vorschauphase. Die Tool-Verträge und das Bereitstellungsmodell entwickeln sich noch weiter; behandeln Sie die aktuelle Version nicht als gehosteten Dienst oder als universellen Anti-Bot-Bypass.

Warum Groundlane?

• Modellneutral: Verbinden Sie einen beliebigen Streamable-HTTP-MCP-Client, anstatt sich auf das integrierte Web-Tool eines Modellanbieters zu verlassen.

• Anbieterneutral: Routen Sie über Such-APIs mit wiederkehrenden monatlichen Freikontingenten hinter einem einheitlichen Ergebnisvertrag.

• HTTP zuerst, Browser bei Bedarf: Halten Sie normale Lesevorgänge schnell und reservieren Sie Chromium für JavaScript, Wartebedingungen und unterstützte Fallback-Signale.

• Deterministische Extraktion: Wählen Sie Felder mit CSS-Selektoren aus und erhalten Sie strukturiertes JSON ohne impliziten LLM-Schritt.

• Sicherheit zuerst: Authentifizieren Sie den MCP-Endpunkt und wenden Sie URL-, Redirect-, Netzwerk-, Deadline-, Byte-, Ausgabe- und Parallelitätslimits an.

• Selbstkontrollierte Bereitstellung: Betreiben Sie die Steuerungsebene und die Browser-Workload in Ihrer eigenen Umgebung, einschließlich Cloudflare Workers und Containers.

Related MCP server: agentfetch

MVP-Tools

Browser-Automatisierung ist ein internes Implementierungsdetail namens Groundlane Browser. Groundlane stellt im MVP keine persistenten Browser-Sitzungen bereit.

Schnellstart

Voraussetzungen

• Node.js 22 oder neuer

• pnpm 10

• Chromium für den Browser-Fallback

• Mindestens einen unterstützten Suchanbieter-Schlüssel mit monatlichem Freikontingent, wenn Sie web_search verwenden möchten (Tavily, Exa, Parallel, Browserbase, Brave, Firecrawl oder SerpApi)

Lokal ausführen

Klonen Sie dieses Repository und führen Sie dann aus:

pnpm install
pnpm exec playwright install chromium
cp .env.example .env
set -a
source .env
set +a
pnpm dev

Setzen Sie ein starkes GROUNDLANE_AUTH_TOKEN in .env. Fügen Sie einen oder mehrere unterstützte Anbieter-Schlüssel hinzu, um die Suche zu aktivieren. Der lokale Server lauscht auf dem konfigurierten PORT und stellt bereit:

• POST /mcp — authentifizierter Streamable-HTTP-MCP-Endpunkt

• GET /healthz — Prozess-Liveness

• GET /readyz — Container-Erreichbarkeit und Service-Konfigurationsbereitschaft

Einen MCP-Client verbinden

Konfigurieren Sie einen Streamable-HTTP-MCP-Client mit der Server-URL und dem Bearer-Token. Die Client-Konfigurationsformen unterscheiden sich, aber die Verbindungswerte sind:

URL: http://localhost:8080/mcp
Authorization: Bearer <GROUNDLANE_AUTH_TOKEN>

Setzen Sie das Token niemals in eine Query-String oder committen Sie es in die Versionskontrolle.

Bei laufendem Server öffnen Sie eine andere Shell, laden Sie dieselbe .env und verifizieren Sie den MCP-Handshake und den öffentlichen HTTP-Pfad:

set -a
source .env
set +a
pnpm smoke

Setzen Sie GROUNDLANE_SMOKE_BROWSER=1, um den Browser-Pfad einzuschließen.

Konfiguration

Groundlane liest die Konfiguration aus Umgebungsvariablen. Siehe .env.example für eine vollständige lokale Vorlage.

Fehlende Such-Anmeldedaten verhindern nicht, dass web_fetch oder web_extract funktionieren. Sie machen den entsprechenden Suchanbieter jedoch nicht verfügbar.

Monatliche Budgets zählen versuchte Anbieter-Anfragen, einschließlich wiederholbarer Fehler, und verhindern, dass eine laufende Groundlane-Instanz einen Anbieter nach Erreichen seines Limits auswählt. Sie sind bewusst konservativ, aber keine Abrechnungswahrheit: Container starten neu, mehrere Instanzen teilen keine Zähler, und einige Anbieter berechnen variable Credits. Halten Sie anbieterseitige Ausgabenlimits aktiviert und überschreiben Sie die Budgets für Ihre tatsächlichen Pläne.

Architektur

MCP client
    |
    v
Cloudflare Worker / Node HTTP edge
    |  authentication, limits, request identity
    v
tool registry
    |-- web_search  -> monthly-free provider router (7 adapters)
    |-- web_fetch   -> safe HTTP -> optional Jina Reader -> browser fallback
    `-- web_extract -> fetch pipeline -> deterministic DOM extraction

Kernrichtlinien und -verträge hängen nicht von einem Anbieter oder einer Browser-Laufzeit ab. Adapter sitzen hinter schmalen Schnittstellen. Das Browser-Backend kann Container-lokales Playwright oder Browserless /content sein; engine- und backend-Ausgabefelder legen offen, welcher Pfad ein Ergebnis erzeugt hat, ohne die öffentlichen MCP-Tools zu ändern. Gehostete Backends erhalten die angeforderte öffentliche URL, sind also opt-in und keine stillen Standardwerte.

Lesen Sie Architektur für Komponentengrenzen, Anfragefluss und Designentscheidungen.

Sicherheit

Web-Abruf ist eine SSRF-empfindliche Fähigkeit. Groundlane behandelt Benutzer-URLs, Redirects, Browser-Subressourcen und Suchanbieter-URLs als nicht vertrauenswürdig. Bereitstellungen sollten die Authentifizierung aktiviert lassen, eine ausgehende Netzwerkrichtlinie verwenden und die Standard-Ressourcenlimits beibehalten.

Das Projekt verspricht keine universelle CAPTCHA-Lösung, unsichtbare Automatisierung oder Zugriff auf Inhalte, die Sie nicht abrufen dürfen. Betreiber sind für die Bedingungen der Zielseite, Robots-Richtlinien, Datenschutzpflichten und geltendes Recht verantwortlich.

Siehe SECURITY.md für das Sicherheitsmodell und den privaten Prozess zur Meldung von Schwachstellen.

Bereitstellung

Die vorgesehene Produktionstopologie verwendet einen Cloudflare Worker als öffentliche Steuerungsebene und einen Cloudflare Container für die Node/Playwright-Browser-Workload. Für Voraussetzungen, Geheimnisse, Bereitstellungsschritte und Verifizierung siehe Bereitstellung auf Cloudflare.

Roadmap

• Die anbieterneutrale web_fetch-, web_search- und deterministische web_extract-Oberfläche definieren

• Opt-in Jina Reader und Browserless-Abruf-Backends mit Provenienz hinzufügen

• MCP-Verträge stabilisieren und Kompatibilitäts-Fixtures veröffentlichen

• Cloudflare Worker + Container-Bereitstellung und Betriebstelemetrie härten

• Cache-Adapter und anbieter-/kostenbewusstes Routing hinzufügen

• Opt-in Batch/Crawl-Primitive mit expliziten Budgets hinzufügen

• Zustandsbehaftete Browser-Sitzungen als separate, lebenszyklussichere Fähigkeit bewerten

Die Roadmap ist richtungsweisend, keine Veröffentlichungsverpflichtung. Siehe das Forschungsarchiv für die Belege hinter dem aktuellen Umfang.

Dokumentation

• Architektur

• MVP-Produktanforderungen

• Cloudflare-Bereitstellung

• Sicherheitsrichtlinie

• Mitwirken

• Forschungsarchiv

Mitwirken

Issues und Pull Requests sind willkommen. Bevor Sie mitwirken, lesen Sie CONTRIBUTING.md und den Verhaltenskodex. Sicherheitslücken müssen privat gemeldet werden, wie in SECURITY.md beschrieben.

Lizenz

Groundlane ist unter der Apache License 2.0 lizenziert.