Stellara

Stellara — это самохостинговый шлюз инструментов ИИ для Firecrawl, Exa, Qdrant и бэкенда эмбеддингов. Он предоставляет единый защищённый токеном интерфейс HTTP и Model Context Protocol (MCP) для LLM-клиентов, таких как Claude Desktop и коннекторы ChatGPT.

Шлюз централизует учётные данные внешних сервисов, аутентификацию, ограничения скорости, проверку ответов и сетевые механизмы защиты. Он также предоставляет сеансы браузера Playwright, векторную память для каждого пользователя и проверку доступности доменов.

Возможности

• web_* — поиск, скрейпинг, краулинг, извлечение данных и выполнение защищённых HTTP- или GraphQL-запросов.

• browser_* — запуск интерактивных сеансов Playwright для навигации, работы с формами, снимков экрана, PDF и выполнения JavaScript.

• memory_* — сохранение и получение контекста каждого пользователя через эмбеддинги и Qdrant.

• domain_availability — проверка регистрации домена через RDAP с резервным вариантом WHOIS.

• OAuth 2.1 и MCP — подключение клиентов на основе токенов или MCP-клиентов с поддержкой OAuth через единый шлюз.

Полный каталог см. в справочнике инструментов.

Related MCP server: webcrawl-mcp

Требования

• Node.js 24 или новее

• pnpm 10.33.4 через Corepack

• Учётные данные провайдеров для активируемых функций

• Docker для развёртывания в контейнере

Локальная разработка

corepack enable
pnpm install
cp .env.example .env

Укажите публичный базовый URL, хотя бы один STELLARA_TOKEN_<USERID> и требуемые значения Firecrawl в файле .env. Необязательные учётные данные Exa, Qdrant и эмбеддингов активируют соответствующие семейства инструментов.

Запустите сервер разработки:

pnpm dev

Эндпоинт проверки состояния доступен по адресу http://localhost:8787/health, если не изменён PORT.

Развёртывание в контейнере

Поддерживаемый образ контейнера — 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 перед открытием pull request. Используйте GitHub Issues для воспроизводимых ошибок и точечных предложений новых функций. Политику поддержки проекта см. в SUPPORT.md.

Сообщайте об уязвимостях безопасности в частном порядке, как описано в SECURITY.md. Не раскрывайте уязвимости в публичных issues.

Лицензия

Stellara распространяется под лицензией MIT.