Firenook MCP
Firenook заменяет эмулятор Firebase быстрым нативным движком и отдает агенту через MCP запущенные Firestore, Auth и Storage.
- 102 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент может записывать и удалять документы, пользователей и файлы в эмуляторе, в том числе рекурсивно.
- Вызовы идут с токеном владельца и обходят правила безопасности.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/firenookОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент может записывать и удалять документы, пользователей и файлы в эмуляторе, в том числе рекурсивно.
- Вызовы идут с токеном владельца и обходят правила безопасности.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Firenook — совместимая замена Firebase Local Emulator Suite: читает `firebase.json`, правила и индексы, обслуживает Firestore, Auth, Storage, Functions, Pub/Sub, Cloud Tasks и Eventarc на тех же портах. Данные сохраняются между запусками флагом `--keep-data`. Команда `firenook mcp` запускает MCP-сервер по stdio. Агент читает и пишет документы Firestore, создает пользователей и выпускает для них токены, смотрит логи и каждый вызов функции с ошибкой, спрашивает у правил безопасности причину отказа, работает с файлами Storage, Pub/Sub, Cloud Tasks и Eventarc. Группы инструментов выбираются через `--only`.
Для кого. Разработчикам приложений на Firebase, которые гоняют локальный эмулятор и хотят, чтобы агент сам смотрел данные, пользователей и ошибки функций.
Подходит, если
- Функция падает в эмуляторе, и агенту нужно найти вызов с трассой ошибки.
- Запрос к Firestore отклонен, и нужно выяснить, какое правило безопасности его блокирует.
- Для проверки нужен пользователь с особыми claims и токен для вызова функции от его имени.
- Эмулятор Firebase на Java съедает память, а данные теряются при остановке.
Не подходит, если
- Нужен доступ к боевому проекту Firebase: сервер работает только с локальным набором.
- Проект зависит от эмуляторов, которых в списке Firenook нет: сверьтесь с файлом совместимости.
- Агент не должен менять данные эмулятора.
Пример запроса к агенту
Прочитай коллекцию `orders` в эмуляторе, найди заказы без поля `status` и объясни, почему запись из приложения отклонена правилами.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужен Node 22, 24 или 26 и запущенный `firenook emulators:start`: без него инструменты возвращают понятную ошибку. Инструменты с пометкой console работают только при включенном интерфейсе эмулятора (по умолчанию он включен). Расширения из реестра скачиваются один раз при первом использовании. Вызовы к эмулятору идут с токеном владельца, как у Admin SDK, поэтому правила безопасности они не проверяют. Совместимость с вашим проектом сверяйте по файлу `COMPATIBILITY.md`.
Как отключить. Удалите запись `firenook` из `.mcp.json` или конфигурации клиента. Эмулятор остановите как обычно, пакет уберите командой `npm uninstall firenook`.
Частые вопросы
Как подключить сервер к агенту?
Выполните `npx firenook mcp add` в папке проекта: команда сама запишет настройки для найденных Claude Code, Cursor и VS Code. Для Codex используйте `codex mcp add firenook -- npx firenook mcp`.
Затронет ли агент боевые данные?
Нет, сервер видит только локальный набор эмуляторов на этой машине, и данные из него никуда не уходят.
Как ограничить набор инструментов?
Запустите `firenook mcp --only firestore,auth`. Инструменты `firenook_status` и `emulators_export` доступны всегда.
Что делать, если эмуляторов запущено несколько?
Задайте проект явно: `--project <id>` или `--config /path/to/firebase.json`. Иначе инструменты назовут оба набора и попросят уточнить.
Нужен ли Java и firebase-tools?
Нет, Firenook ставится одним npm-пакетом с нативным движком. Оставьте `firebase-tools` только для остальных команд Firebase CLI.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыFirebase MCP Server
Firebase CLI and MCP Server
Официальный MCP-сервер Firebase из состава Firebase CLI: проекты, Firestore, Auth, Crashlytics, Remote Config и логи функций
MCP-сервер FireCMS Cloud: агент читает данные Firestore, выводит схемы коллекций и управляет пользователями проекта.
Эмулятор DynamoDB на Rust с SQLite внутри стартует за миллисекунды и работает как HTTP-сервер или MCP-сервер для агентов.
MCP-сервер и плагин для агентов генерируют веб-API из спецификаций OpenAPI, AsyncAPI, GraphQL, gRPC и SQL на ядре Rust.
MCP-сервер для приложений на Lunora: агент читает функции, таблицы, логи и ошибки развернутого бэкенда и вызывает запросы.
Официальный плагин Firebase: 14 скиллов по Firestore, Auth, Hosting, Crashlytics, Remote Config и правилам безопасности
Коротко о README
Замена эмулятора в одну команду: в `package.json` вместо `firebase emulators:start` идет `firenook emulators:start`. Для агентов есть `firenook mcp` и `firenook mcp add`.