Stellara

Stellara ist ein selbst gehostetes KI-Tool-Gateway für Firecrawl, Exa, Qdrant und ein Embeddings-Backend. Es stellt eine token-geschützte HTTP- und Model Context Protocol (MCP)-Schnittstelle für LLM-Clients wie Claude Desktop und ChatGPT-Konnektoren bereit.

Das Gateway zentralisiert Upstream-Zugangsdaten, Authentifizierung, Ratenlimits, Antwortvalidierung und Netzwerkschutzmechanismen. Es bietet außerdem Playwright-Browsersitzungen, benutzerspezifischen Vektorspeicher und Domain-Verfügbarkeitsprüfungen.

Funktionen

• web_* — durchsuchen, scrapen, crawlen, extrahieren und abgesicherte HTTP- oder GraphQL-Anfragen stellen.

• browser_* — interaktive Playwright-Sitzungen für Navigation, Formulare, Screenshots, PDFs und JavaScript-Auswertung ausführen.

• memory_* — benutzerspezifischen Kontext über Embeddings und Qdrant speichern und abrufen.

• domain_availability — Domain-Registrierung über RDAP mit WHOIS-Fallback prüfen.

• OAuth 2.1 und MCP — tokenbasierte Clients oder OAuth-fähige MCP-Clients über ein einziges Gateway verbinden.

Siehe die Tool-Referenz für den vollständigen Katalog.

Related MCP server: webcrawl-mcp

Voraussetzungen

• Node.js 24 oder neuer

• pnpm 10.33.4 über Corepack

• Anbieter-Zugangsdaten für die Funktionen, die Sie aktivieren

• Docker für die Container-Bereitstellung

Lokale Entwicklung

corepack enable
pnpm install
cp .env.example .env

Legen Sie eine öffentliche Basis-URL, mindestens einen STELLARA_TOKEN_<USERID> und die erforderlichen Firecrawl-Werte in .env fest. Optionale Exa-, Qdrant- und Embeddings-Zugangsdaten aktivieren die zugehörigen Tool-Familien.

Starten Sie den Entwicklungsserver:

pnpm dev

Der Health-Endpunkt ist unter http://localhost:8787/health verfügbar, sofern PORT nicht geändert wird.

Container-Bereitstellung

Das unterstützte Container-Image ist ghcr.io/sebastian-software/stellara. Versionierte Releases veröffentlichen einen stabilen Patch-Tag sowie die beweglichen Minor- und latest-Tags.

Kopieren Sie .env.example zu .env, konfigurieren Sie das externe Proxy-Netzwerk, bereiten Sie stellara-data/ für UID/GID 999 vor und starten Sie dann den Dienst:

docker compose up -d

Lesen Sie die Betriebsanleitung, bevor Sie den Dienst freigeben. Sie behandelt Proxy-Vertrauen, OAuth-Persistenz, Backup und Wiederherstellung.

Entwicklung und Tests

Das erforderliche lokale Qualitäts-Gate ist:

pnpm agent:check

Dieser Befehl führt Typprüfung, Linting, Formatierungsprüfung und die hermetische Unit-Test-Suite aus. Live-Provider-Tests sind optional, ausschließlich lokal und erfordern Zugangsdaten, die über normale Umgebungsvariablen bereitgestellt werden:

pnpm test:integration

GitHub Actions erhält diese Integrations-Zugangsdaten niemals und führt sie auch nicht aus.

Dokumentation

• Benutzerhandbuch

• Tool-Referenz

• Entwicklungsleitfaden

• Tool-API

• Teststrategie

• Architektur

• Betrieb

• Release-Prozess

Einige ausführliche Dokumentationen sind derzeit auf Deutsch verfügbar. Die Übersetzungsarbeit wird im öffentlichen Issue-Tracker verfolgt.

Mitwirken und Support

Lesen Sie CONTRIBUTING.md, bevor Sie einen Pull-Request eröffnen. Nutzen Sie GitHub Issues für reproduzierbare Fehler und gezielte Funktionsvorschläge. Die Support-Richtlinie des Projekts finden Sie in SUPPORT.md.

Melden Sie Sicherheitslücken vertraulich, wie in SECURITY.md beschrieben. Machen Sie Sicherheitslücken nicht in öffentlichen Issues bekannt.

Lizenz

Stellara ist unter der MIT-Lizenz verfügbar.