Stellara

Stellara は、Firecrawl、Exa、Qdrant、および埋め込みバックエンド向けのセルフホスト型 AI ツールゲートウェイです。Claude Desktop や ChatGPT コネクタなどの LLM クライアントに対して、トークンで保護された単一の HTTP および Model Context Protocol (MCP) インターフェースを提供します。

このゲートウェイは、アップストリームの認証情報、認証、レート制限、レスポンス検証、ネットワーク保護を一元管理します。また、Playwright ブラウザセッション、ユーザーごとのベクトルメモリ、ドメイン利用可能性のチェックも提供します。

機能

• web_* — 検索、スクレイピング、クロール、抽出、および保護付き HTTP または GraphQL リクエストを実行します。

• browser_* — ナビゲーション、フォーム、スクリーンショット、PDF、JavaScript 評価のための対話型 Playwright セッションを実行します。

• memory_* — 埋め込みと Qdrant を通じて、ユーザーごとのコンテキストを保存および取得します。

• domain_availability — WHOIS フォールバック付きの RDAP を通じてドメイン登録を確認します。

• OAuth 2.1 と MCP — トークンベースのクライアントまたは OAuth 対応 MCP クライアントを 1 つのゲートウェイで接続します。

完全なカタログについては、ツールリファレンス を参照してください。

Related MCP server: webcrawl-mcp

要件

• Node.js 24 以上

• Corepack 経由の pnpm 10.33.4

• 有効にする機能のプロバイダー認証情報

• コンテナ展開用の Docker

ローカル開発

corepack enable
pnpm install
cp .env.example .env

.env に、公開ベース URL、少なくとも 1 つの STELLARA_TOKEN_<USERID>、および必要な Firecrawl の値を設定します。Exa、Qdrant、および埋め込みの認証情報は任意で、これらを設定すると対応するツールファミリーが有効になります。

開発サーバーを起動します:

pnpm dev

PORT が変更されていない限り、ヘルスエンドポイントは http://localhost:8787/health で利用できます。

コンテナ展開

サポートされているコンテナイメージは ghcr.io/sebastian-software/stellara です。バージョン付きリリースでは、安定したパッチタグに加えて、移動するマイナータグと latest タグが公開されます。

.env.example を .env にコピーし、外部プロキシネットワークを設定し、stellara-data/ を UID/GID 999 用に準備してから、サービスを起動します:

docker compose up -d

サービスを公開する前に、運用ガイド を読んでください。このガイドでは、プロキシの信頼、OAuth の永続化、バックアップ、リカバリについて説明しています。

開発とテスト

必要なローカル品質ゲートは次のとおりです:

pnpm agent:check

このコマンドは、型チェック、リンティング、フォーマット検証、および隔離されたユニットテストスイートを実行します。ライブプロバイダーテストは任意で、ローカルのみで実行され、通常の環境変数を介して提供される認証情報が必要です:

pnpm test:integration

GitHub Actions はこれらの統合認証情報を受け取ることも、それらを使用して実行することもありません。

ドキュメント

• ユーザーガイド

• ツールリファレンス

• 開発ガイド

• ツール API

• テスト戦略

• アーキテクチャ

• 運用

• リリースプロセス

詳細なドキュメントの一部は現在ドイツ語でのみ提供されています。翻訳作業は公開イシュートラッカーで管理されています。

コントリビューションとサポート

プルリクエストを開く前に CONTRIBUTING.md を読んでください。再現可能なバグと焦点を絞った機能提案には GitHub Issues を使用してください。プロジェクトのサポートポリシーについては SUPPORT.md を参照してください。

セキュリティの脆弱性は、SECURITY.md の説明に従って非公開で報告してください。脆弱性を公開のイシューで開示しないでください。

ライセンス

Stellara は MIT License の下で利用できます。