Stellara

Stellara 是面向 Firecrawl、Exa、Qdrant 和嵌入后端的自托管 AI 工具网关。它为 Claude Desktop 和 ChatGPT 连接器等 LLM 客户端提供一个受令牌保护的 HTTP 和模型上下文协议 (MCP) 接口。

该网关集中管理上游凭据、身份验证、速率限制、响应验证和网络安全防护。它还提供 Playwright 浏览器会话、每用户向量记忆以及域名可用性检查。

功能

• web_* — 搜索、抓取、爬取、提取，并发出受保护的 HTTP 或 GraphQL 请求。

• browser_* — 运行交互式 Playwright 会话，用于页面导航、表单操作、截图、PDF 生成和 JavaScript 求值。

• memory_* — 通过嵌入和 Qdrant 存储和检索每用户上下文。

• domain_availability — 通过 RDAP 检查域名注册情况，并以 WHOIS 作为回退方案。

• 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

健康检查端点位于 http://localhost:8787/health，除非修改了 PORT。

容器部署

受支持的容器镜像是 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 许可证 下发布。