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 클라이언트를 연결합니다.

전체 카탈로그는 도구 참조를 참조하세요.

Related MCP server: webcrawl-mcp

요구 사항

• Node.js 24 이상

• Corepack을 통한 pnpm 10.33.4

• 활성화하는 기능에 필요한 공급자 자격 증명

• 컨테이너 배포를 위한 Docker

로컬 개발

corepack enable
pnpm install
cp .env.example .env

.env에 공개 기본 URL, 하나 이상의 STELLARA_TOKEN_<USERID> 및 필요한 Firecrawl 값을 설정하세요. 선택적 Exa, Qdrant 및 임베딩 자격 증명은 해당하는 도구 모음을 활성화합니다.

개발 서버를 시작합니다:

pnpm dev

PORT를 변경하지 않으면 상태 엔드포인트는 http://localhost:8787/health에서 사용할 수 있습니다.

컨테이너 배포

지원되는 컨테이너 이미지는 ghcr.io/sebastian-software/stellara입니다. 버전이 지정된 릴리스는 안정적인 패치 태그와 함께 이동하는 마이너 태그 및 latest 태그를 게시합니다.

.env.example을 .env로 복사하고, 외부 프록시 네트워크를 구성하고, UID/GID 999용 stellara-data/를 준비한 다음 서비스를 시작합니다:

docker compose up -d

서비스를 노출하기 전에 운영 가이드를 읽으세요. 프록시 신뢰, OAuth 영속성, 백업 및 복구를 다룹니다.

개발 및 테스트

필요한 로컬 품질 게이트는 다음과 같습니다:

pnpm agent:check

이 명령은 타입 검사, 린팅, 포맷 검증 및 밀폐형 단위 테스트 모음을 실행합니다. 라이브 공급자 테스트는 선택 사항이며 로컬 전용이고 일반 환경 변수를 통해 제공되는 자격 증명이 필요합니다:

pnpm test:integration

GitHub Actions는 이러한 통합 자격 증명을 수신하거나 실행하지 않습니다.

문서

• 사용자 가이드

• 도구 참조

• 개발 가이드

• 도구 API

• 테스트 전략

• 아키텍처

• 운영

• 릴리스 프로세스

일부 심층 문서는 현재 독일어로 제공됩니다. 번역 작업은 공개 이슈 트래커에서 추적됩니다.

기여 및 지원

풀 리퀘스트를 열기 전에 CONTRIBUTING.md를 읽으세요. 재현 가능한 버그와 구체적인 기능 제안은 GitHub Issues를 사용하세요. 프로젝트 지원 정책은 SUPPORT.md를 참조하세요.

보안 취약점은 SECURITY.md에 설명된 대로 비공개로 신고하세요. 공개 이슈에 취약점을 공개하지 마세요.

라이선스

Stellara는 MIT 라이선스에 따라 제공됩니다.