Lunora MCP
MCP-сервер для приложений на Lunora: агент читает функции, таблицы, логи и ошибки развернутого бэкенда и вызывает запросы.
- 296 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Админ-токен открывает агенту схему, логи и ошибки продакшена, а они могут содержать данные пользователей.
- После включения записи агент вызывает мутации и действия приложения, хотя каждый вызов требует подтверждения.
Установка
- Работает в
Ручная установка
npm install @lunora/mcpПервая команда из README пакета. Сервер запускается бинарным файлом `lunora-mcp`, а `lunora mcp install` подключает серверы к редактору.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Админ-токен открывает агенту схему, логи и ошибки продакшена, а они могут содержать данные пользователей.
- После включения записи агент вызывает мутации и действия приложения, хотя каждый вызов требует подтверждения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пакет `@lunora/mcp` подключает к агенту развернутое приложение на Lunora, типобезопасном бэкенде реального времени для Cloudflare Workers и Durable Objects. Инструменты `lunora_list_functions`, `lunora_list_tables` и `lunora_get_function_schema` показывают публичные функции, таблицы и аргументы, а `lunora_run_query` выполняет запрос только на чтение. Для владельца приложения есть наблюдаемость: логи, ошибки, сгруппированные в Issues, рекомендации по схеме и запросам, статус миграций и очередь отложенных задач. Мутации и действия отключены по умолчанию и требуют два шага: сервер сначала возвращает предложенное действие с подписью, затем выполняет его после подтверждения с этой подписью. Отдельный сервер документации на `https://lunora.sh/mcp` не требует ключей и подсказывает агенту настоящий API фреймворка.
Для кого. Разработчикам, которые строят приложение на Lunora и хотят, чтобы агент отлаживал его по логам и схеме без догадок.
Подходит, если
- После деплоя в Cloudflare растет число ошибок, и агент должен найти их группы в Issues.
- Агенту нужно узнать, какие запросы и мутации есть в приложении, и собрать корректные аргументы.
- Пишут код на Lunora, а агент придумывает несуществующие методы фреймворка.
- Медленные запросы ищут по статистике выполнения отдельных выражений.
- Перед релизом выясняют, какие миграции применены, а какие ждут очереди.
Не подходит, если
- Приложение написано не на Lunora: сервер работает только с ее RPC.
- Админ-токен продакшена нельзя передавать агенту и тем более модели стороннего провайдера.
- Нужен готовый MCP для Cloudflare в целом: сервер видит только функции и данные приложения Lunora.
Пример запроса к агенту
Подключись к приложению Lunora, покажи группы ошибок за последний час и найди функцию, которая их вызывает.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
LUNORA_URLобязательная- Адрес развернутого приложения Lunora.
LUNORA_ADMIN_TOKENобязательная, секрет- Админ-токен развертывания.
LUNORA_MCP_ALLOW_WRITES- Включает инструменты записи, по умолчанию выключены.
LUNORA_MCP_ALLOW_OBSERVABILITY- Открывает инструменты логов, ошибок и миграций.
Ограничения
Фреймворк находится в стадии «alpha»: пакет npm называется `lunorash`, ставится с тегом `@alpha`, а до первого стабильного выпуска возможны ломающие изменения. Сервер требует `LUNORA_URL` и `LUNORA_ADMIN_TOKEN`. Запись включает переменная `LUNORA_MCP_ALLOW_WRITES`, инструменты логов и ошибок — `LUNORA_MCP_ALLOW_OBSERVABILITY=1`. Подтверждение записи доказывает неизменность предложенного вызова и ничего не говорит о присутствии человека: решение остается за клиентом агента. Логи и ошибки попадают в контекст модели вместе с пользовательскими данными. Лицензия — FSL-1.1-Apache-2.0.
Как отключить. Удалите запись `lunora` из конфигурации MCP и сбросьте токен `LUNORA_ADMIN_TOKEN` в приложении. Если сервер поднимали для HTTP, остановите и его.
Частые вопросы
Как подключить Lunora MCP к Claude Code или Cursor?
Добавьте в конфигурацию MCP сервер `lunora` с командой `lunora-mcp` и переменными `LUNORA_URL` и `LUNORA_ADMIN_TOKEN`. Большинству пользователей проще выполнить `lunora mcp install`: команда подключает и серверный, и документационный MCP к редактору.
Может ли агент менять данные в приложении?
Только если включить `LUNORA_MCP_ALLOW_WRITES`. Даже тогда `lunora_run_mutation` и `lunora_run_action` работают в два вызова: первый возвращает предложение и подпись, второй с `confirmed: true` и подписью выполняет действие.
Чем отличается сервер документации от основного?
Сервер документации не обращается к вашему приложению и не требует ключей, он доступен по адресу `https://lunora.sh/mcp`. Основной сервер работает с вашим развертыванием по админ-токену.
Как включить инструменты логов и ошибок?
Установите `LUNORA_MCP_ALLOW_OBSERVABILITY=1`. По умолчанию пять инструментов `lunora_get_*` скрыты, так как логи могут содержать данные пользователей.
Есть ли у Lunora скиллы для агентов?
Да. Пакет `@lunora/cli` содержит 15 скиллов: от `lunora-quickstart` и `lunora-functions` до `lunora-deploy` и `lunora-performance-audit`. Команда `lunora rules install` копирует их в проект.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер Apollo: превращает заданные операции GraphQL в инструменты, через которые агент работает с вашим API
MCP-сервер очереди задач bunqueue: агент ставит cron, повторяет упавшие задачи, ставит лимиты и читает статистику, без Redis.
Firebase MCP Server
Firebase CLI and MCP Server
Официальный MCP-сервер Firebase из состава Firebase CLI: проекты, Firestore, Auth, Crashlytics, Remote Config и логи функций
Пакет для Laravel и Lumen, который добавляет MCP-эндпоинт в маршруты приложения и подключает к нему ваши инструменты
MCP-сервер FireCMS Cloud: агент читает данные Firestore, выводит схемы коллекций и управляет пользователями проекта.
PubNub MCP — документация и приложения PubNub в агенте
PubNub MCP Server
Официальный MCP-сервер PubNub: документация SDK на 20 языках и управление приложениями, ключами, каналами и аналитикой из агента
Коротко о README
README пакета делит возможности на сервер развертывания и сервер документации. Отдельные разделы описывают подтверждение записи, наблюдаемость, публикацию функций приложения как инструментов по документу OpenRPC и запуск долгоживущих агентов.