bunqueue MCP
MCP-сервер очереди задач bunqueue: агент ставит cron, повторяет упавшие задачи, ставит лимиты и читает статистику, без Redis.
- 592 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент может ставить, повторять и удалять задачи и регистрировать HTTP-адреса, которые воркер вызовет для каждой задачи.
- Без профиля `agent` разрушающие вызовы выполняются без подтверждения.
Установка
- Работает в
Ручная установка
claude mcp add bunqueue -e BUNQUEUE_MCP_PROFILE=agent -- bunx --package=bunqueue bunqueue-mcpКоманда из README. Пакет @modelcontextprotocol/sdk ставят как необязательную зависимость: bun add bunqueue @modelcontextprotocol/sdk.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент может ставить, повторять и удалять задачи и регистрировать HTTP-адреса, которые воркер вызовет для каждой задачи.
- Без профиля `agent` разрушающие вызовы выполняются без подтверждения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`bunqueue` — очередь задач для Bun с SQLite по умолчанию и PostgreSQL для нескольких брокеров. В нее встроены `dead` `letter` `queue`, cron, резервные копии SQLite в S3 и MCP-сервер, а Redis не нужен. Карточка описывает сервер `bunqueue-mcp`: 79 основных инструментов, пять ресурсов и три промпта. Агент через них ставит задачи по расписанию, добавляет и обрабатывает задачи, повторяет упавшие, настраивает лимиты скорости и читает статистику без собственной обвязки. Инструменты включают постраничный просмотр, наблюдение за задачей и диагностику очереди. HTTP-обработчики дают агенту зарегистрировать адрес, который воркер будет вызывать для каждой задачи. Два шаблона ресурсов ограничивают чтение одной очередью, а страницы по очереди по умолчанию не содержат тела задач. Дополнительно включаются до трех инструментов рабочих процессов. Сервер работает по stdio или Streamable HTTP. Профиль `agent` включает динамические наборы инструментов и подтверждение деструктивных вызовов. Проверить настройку до подключения можно командой `BUNQUEUE_MCP_PROFILE=agent bunx --package=bunqueue bunqueue-mcp --doctor --json`: она не открывает встроенные базы.
Для кого. Разработчикам на Bun и Node.js, у которых фоновые задачи и расписания живут в `bunqueue` и которым нужно, чтобы агент сам управлял очередями и разбирал сбои.
Подходит, если
- Утром надо посмотреть все упавшие задачи и повторить те, у которых причина устранена.
- Ежедневную очистку нужно поставить на три часа ночи одной фразой.
- Для очереди внешнего API нужно выставить лимит 50 задач в секунду.
- Агенту нужен диагноз, почему очередь стоит: где застряли задачи и что в `dead` `letter` `queue`.
- Для долгих шагов агента нужна очередь с сохранением состояния в SQLite вместо Redis.
Не подходит, если
- Очередь работает на BullMQ или другом брокере: сервер управляет только `bunqueue`.
- В проекте нет Bun: для запуска сервера используется `bunx`.
- Агенту нельзя давать управление задачами боевой очереди без подтверждения: в профиле по умолчанию это не включено.
Пример запроса к агенту
Покажи все упавшие задачи очереди `emails`, повтори те, что упали из-за таймаута, и поставь лимит 50 в секунду на очередь api-calls.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
BUNQUEUE_MCP_PROFILE- Профиль сервера, в примерах README задано значение agent.
Ограничения
Для запуска нужен Bun, а пакет `@modelcontextprotocol/sdk` ставится как необязательная зависимость. Без профиля `agent` динамические наборы инструментов и подтверждение разрушающих вызовов не включены.
Для устойчивых ходов агента автор отсылает к `Workflow` и `Engine` и журналу `bunqueue/agents`. Возобновление сессии и повторы очереди по-прежнему требуют идемпотентности у провайдера и ручной сверки внешних эффектов. Перед заявлением об успехе нужно прочитать итоговое состояние задачи.
Как отключить. Выполните `claude mcp remove bunqueue` или удалите запись `bunqueue` из `mcpServers` вашего клиента.
Частые вопросы
Как подключить `bunqueue` к Claude Code?
Командой `claude mcp add bunqueue -e BUNQUEUE_MCP_PROFILE=agent -- bunx --package=bunqueue bunqueue-mcp`. Для Claude Desktop, Cursor и Windsurf тот же `bunx` вносят в `mcpServers`.
Сколько инструментов в сервере?
79 основных, пять ресурсов и три промпта. Дополнительно включаются до трех инструментов рабочих процессов, а динамические инструменты поиска считаются отдельно.
Нужен ли Redis?
Нет. По умолчанию данные лежат в SQLite, а при росте можно взять мультиброкерный режим на PostgreSQL.
Какие клиенты и транспорты поддерживаются?
Claude Code, Claude Desktop, Cursor и Windsurf. Сервер работает по stdio или Streamable HTTP, примеры конфигураций даны в README.
Как проверить настройку заранее?
Выполните `BUNQUEUE_MCP_PROFILE=agent bunx --package=bunqueue bunqueue-mcp --doctor --json`. Проверка выводит готовность и не открывает встроенные базы.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для приложений на Lunora: агент читает функции, таблицы, логи и ошибки развернутого бэкенда и вызывает запросы.
MCP-сервер Rebase: агент правит схему, документы и пользователей бэкенда на Postgres, запись разрешена лишь на localhost
MCP-сервер и плагин для агентов генерируют веб-API из спецификаций OpenAPI, AsyncAPI, GraphQL, gRPC и SQL на ядре Rust.
MCP-сервер для PostgreSQL с подбором индексов, планами EXPLAIN, проверкой здоровья базы и режимом только чтения
MCP-сервер Apollo: превращает заданные операции GraphQL в инструменты, через которые агент работает с вашим API
Bitrix24 MCP Server (lstkhN)
Bitrix24 MCP Server
Модуль для коробочного Битрикс24: агент безопасно читает CRM, схему MySQL, код и бизнес-процессы по SSH stdio или HTTP с Bearer-токеном
Коротко о README
README открывается описанием очереди, затем идут примеры API, архитектура, возможности, рабочие процессы и глава «Built for AI Agents» с MCP-сервером, командами подключения и примерами фраз. После нее разделы о дашборде, SDK, CLI и промышленной эксплуатации.