Skip to main content
Glama

О HQBase

HQBase даёт командам единое место для работы с общими почтовыми ящиками, сохраняя приложение, почту и учётные данные Cloudflare в инфраструктуре заказчика. Включает:

  • Общие почтовые ящики и контроль доступа для команды.

  • Мультидоменную настройку, черновики и историю аудита.

  • Установку, обновление, резервное копирование и восстановление.

  • Защищённый OAuth удалённый MCP-сервер.

См. документацию по продукту для установки, повседневного использования, архитектуры и эксплуатации.

Related MCP server: Gmail MCP Connector

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

Запуск приложения

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

Перед запуском необязательной команды seed добавьте эти значения в .dev.vars:

  • BETTER_AUTH_SECRET

  • HQBASE_LOCAL_SEED_PASSWORD длиной от 8 до 128 символов

Команда seed записывает только в локальную D1 и не обращается к Cloudflare OAuth. Откройте http://127.0.0.1:5173/ и войдите как owner@hqbase.test с этим паролем. Vite обслуживает фронтенд с горячей перезагрузкой на порту 5173 и проксирует API-запросы к Wrangler Worker на порту 8787.

Чтобы использовать процесс первоначальной настройки, не запускайте команду seed и откройте http://localhost:5173/setup.

Сброс локальных данных

Чтобы удалить все локальные данные D1, пересоздать схему и воссоздать демонстрационное рабочее пространство:

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

Команда сброса разрушительна и работает только локально. Она не изменяет развёрнутую базу данных.

Предпросмотр интерфейса настройки

Для работы, связанной только с презентацией:

pnpm dev:setup-ui

Откройте http://127.0.0.1:5173/__ui/setup.

Проверка изменений

Запустите полный локальный контроль качества:

pnpm check
pnpm deploy:dry-run

Выполните pnpm cf:typegen после изменения wrangler.jsonc.

Пуш в main запускает тот же контроль качества и пробный деплой. Развёртывание в staging выполняется вручную и также запускается в рамках подписанного рабочего процесса релиза. Релиз остаётся черновиком, пока предыдущая стабильная версия не обновится до точного подписанного кандидата и не пройдёт проверки. Установки и обновления клиентов проверяют подписанный манифест и хэш артефакта перед развёртыванием.

Документация

hqbase.io/docs — публичный источник руководств для пользователей и операторов, спецификаций продукта и процедур для сопровождающих.

Участие в разработке

Прочтите руководство по участию перед созданием pull request.

Безопасность

Чтобы сообщить об уязвимости, следуйте приватной процедуре, описанной в политике безопасности.

Лицензия

HQBase распространяется под GNU Affero General Public License v3.0 only.

Related MCP Connectors

Related MCP Servers

  • 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
  • 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
  • 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
  • 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