Skip to main content
Glama

Stellara

PR CI License: MIT

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: MADPANDA Firecrawl 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

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.

Maintenance

ActivitySlowing
ResponsivenessSlow

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Exposes remote, agent-facing MCP endpoints over Streamable HTTP for web search, webpage parsing, local knowledge-base retrieval and document creation, and delegation of tasks to configurable LLM providers. Also bundles an admin console with onboarding, provider/model configuration, API-key management, and call logging.
    MIT