Skip to main content
Glama
deenesjakoruzh
HQBase

HQBase

Official
by HQBase
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Über HQBase

HQBase bietet Teams einen zentralen Ort für die Arbeit mit gemeinsamen Postfächern – während die Anwendung, die E-Mails und die Cloudflare-Anmeldedaten in der Infrastruktur des Kunden bleiben. Dazu gehören:

  • Gemeinsame Postfächer und Team-Zugriffskontrollen.

  • Multi-Domain-Setup, Entwürfe und Prüfprotokoll (Audit-Trail).

  • Installation, Aktualisierung, Sicherung und Wiederherstellung.

  • Ein OAuth-geschützter Remote-MCP-Server.

Weitere Informationen zu Installation, täglicher Nutzung, Architektur und Betrieb finden Sie in der Produktdokumentation.

Related MCP server: Gmail MCP Connector

Lokale Entwicklung

Anwendung starten

pnpm install
pnpm db:migrate:local
pnpm db:seed:local
pnpm dev

Bevor Sie den optionalen Seed-Befehl ausführen, fügen Sie diese Werte zu .dev.vars hinzu:

  • BETTER_AUTH_SECRET

  • HQBASE_LOCAL_SEED_PASSWORD mit 8 bis 128 Zeichen

Der Seed-Befehl schreibt nur in die lokale D1-Datenbank und kontaktiert kein Cloudflare-OAuth. Öffnen Sie http://127.0.0.1:5173/ und melden Sie sich mit owner@hqbase.test und diesem Passwort an. Vite stellt das Frontend mit Live-Reload auf Port 5173 bereit und leitet API-Anfragen an den Wrangler-Worker auf Port 8787 weiter.

Um den Ersteinrichtungs-Assistenten zu nutzen, lassen Sie den Seed-Befehl weg und öffnen Sie http://localhost:5173/setup.

Lokale Daten zurücksetzen

Um alle lokalen D1-Daten zu verwerfen, das Schema neu aufzubauen und den Demo-Arbeitsbereich neu zu erstellen:

pnpm db:reset:local
pnpm db:seed:local

Der Reset-Befehl ist destruktiv und wirkt nur lokal. Er verändert keine bereitgestellte Datenbank.

Setup-Oberfläche in der Vorschau anzeigen

Für reine Präsentationsarbeiten am Onboarding:

pnpm dev:setup-ui

Öffnen Sie http://127.0.0.1:5173/__ui/setup.

Änderungen prüfen

Führen Sie die vollständige lokale Qualitätsprüfung aus:

pnpm check
pnpm deploy:dry-run

Führen Sie pnpm cf:typegen aus, nachdem Sie wrangler.jsonc geändert haben.

Pushes auf main durchlaufen dieselbe Qualitätsprüfung sowie einen Deployment-Dry-Run. Das bereitgestellte Staging ist manuell und läuft ebenfalls innerhalb des signierten Release-Workflows. Ein Release bleibt im Entwurfsstatus, bis die vorherige stabile Version auf das exakt signierte Kandidaten-Release aktualisiert wurde und alle Prüfungen bestanden hat. Installationen und Updates bei Kunden verifizieren das signierte Manifest und den Artefakt-Digest vor der Bereitstellung.

Dokumentation

hqbase.io/docs ist die öffentliche Quelle für Benutzer- und Betreiberhandbücher, Produktspezifikationen und Wartungsverfahren.

Mitwirken

Bitte lesen Sie den Mitwirkungsleitfaden, bevor Sie einen Pull Request eröffnen.

Sicherheit

Um eine Schwachstelle zu melden, folgen Sie dem privaten Verfahren in der Sicherheitsrichtlinie.

Lizenz

HQBase ist unter der GNU Affero General Public License v3.0 only verfügbar.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive
ResponsivenessWithin a week

Resources

Related MCP Connectors

Related MCP Servers

  • mail-cal-drive-mcp

    rumbitopi
    A
    license
    Not graded
    quality
    D
    maintenance
    A self-hosted MCP server for managing email, calendar, and cloud storage across Microsoft 365, Google Workspace, and IMAP accounts, enabling natural language interaction through any MCP client.
    1
    MIT

  • Gmail MCP Connector

    Gchahm
    A
    license
    Not graded
    quality
    D
    maintenance
    A Gmail MCP server running on Cloudflare Workers that enables reading, searching, labeling, drafting, sending, and managing Gmail messages, including fetching raw attachment bytes, with per-user OAuth authorization.
    375 npm
    1
    MIT

  • Agent Mailbox

    stumct
    A
    license
    Not graded
    quality
    C
    maintenance
    Deploys a self-hosted Cloudflare email service providing short-lived mailboxes with a JSON API and MCP endpoint for automated testing and AI agent signup, verification, and magic-link flows.
    0
    1
    MIT

  • cfmail

    askie
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to autonomously receive, search, read, reply to, and forward email through a self-hosted Cloudflare service accessible via MCP or CLI, with no web interface.
    764 npm
    MIT