Skip to main content
Glama

Bucket Feature Flags MCP Server

Official
by bucketco

CLI-интерфейс ведра

Интерфейс командной строки для взаимодействия со службами Bucket. CLI позволяет управлять приложениями, функциями, аутентификацией и генерировать типы TypeScript для функций Bucket. С помощью этого инструмента вы можете оптимизировать рабочий процесс пометки функций прямо из терминала.

Использование

Начните с локальной установки CLI в вашем проекте:

# npm npm install --save-dev @bucketco/cli # yarn yarn add --dev @bucketco/cli

Затем запустите new команду из корневого каталога вашего проекта, инициализируйте CLI, создайте функцию и сгенерируйте типы одновременно:

# npm npx bucket new # yarn yarn bucket new

Индивидуальные команды

Вместо того, чтобы запускать new вы можете вызывать каждый шаг по отдельности.

# Initialize Bucket in your project (if not already setup) npx bucket init # Create a new feature npx bucket features create "My Feature" # Generate TypeScript types for your features npx bucket features types

Конфигурация

CLI создает файл bucket.config.json в каталоге вашего проекта при запуске bucket init . Этот файл содержит все необходимые настройки для интеграции Bucket.

Структура файла конфигурации

Вот полный список параметров конфигурации, доступных в файле bucket.config.json :

{ "$schema": "https://unpkg.com/@bucketco/cli@latest/schema.json", "baseUrl": "https://app.bucket.co", "apiUrl": "https://app.bucket.co/api", "appId": "ap123456789", "typesOutput": [ { "path": "gen/features.d.ts", "format": "react" } ] }
ВариантОписаниеПо умолчанию
$schemaАвтодополнение для конфигурации. latest можно заменить на конкретную версию." https://unpkg.com/@bucketco/cli@latest/schema.json "
baseUrlБазовый URL для сервисов Bucket." https://app.bucket.co "
apiUrlURL-адрес API для служб Bucket (переопределяет baseUrl для вызовов API)." https://app.bucket.co/api "
appIdВаш идентификатор приложения Bucket.Необходимый
typesOutputПуть(и), где будут сгенерированы типы TypeScript. Может быть строкой или массивом объектов со свойствами path и format . Доступные форматы: react и node ."gen/features.ts" в формате "react"

Вы можете переопределить эти настройки, используя параметры командной строки для отдельных команд.

Команды

bucket init

Инициализируйте новую конфигурацию Bucket в вашем проекте. Это создаст файл bucket.config.json с вашими настройками и запросит любую необходимую информацию, не предоставленную через параметры.

npx bucket init [--overwrite]

Параметры:

  • --overwrite : Перезаписать существующий файл конфигурации, если он существует.
  • --app-id <id> : Установить идентификатор приложения.
  • --key-format <format> : Установить формат ключа для функций.

bucket new [featureName]

Команда «все в одном» для быстрого начала работы. Эта команда объединяет init , создание функций и генерацию типов в одном шаге. Используйте ее для самого быстрого способа начать работу с Bucket.

npx bucket new "My Feature" [--app-id ap123456789] [--key my-feature] [--key-format custom] [--out gen/features.ts] [--format react]

Параметры:

  • --key : Конкретный ключ для функции.
  • --app-id : Идентификатор приложения для использования.
  • --key-format : Формат для функциональных клавиш (пользовательский, змея, верблюд и т. д.).
  • --out : Путь для генерации типов TypeScript.
  • --format : Формат сгенерированных типов (react или node).

Если вы предпочитаете больший контроль над каждым шагом, вы можете использовать отдельные команды ( init , features create , features types ).

bucket login

Войдите в свою учетную запись Bucket. Это позволит аутентифицировать ваш CLI для последующих операций и безопасно сохранить учетные данные.

npx bucket login

bucket logout

Выйдите из своей учетной записи Bucket, удалив сохраненные учетные данные.

npx bucket logout

bucket features

Управляйте функциями Bucket с помощью следующих подкоманд.

bucket features create [featureName]

Создайте новую функцию в приложении Bucket. Команда проведет вас через процесс создания функции с интерактивными подсказками, если параметры не предоставлены.

npx bucket features create "My Feature" [--app-id ap123456789] [--key my-feature] [--key-format custom]

Параметры:

  • --key : Конкретный ключ для функции.
  • --app-id : Идентификатор приложения для использования.
  • --key-format : Формат для функциональных клавиш.
bucket features list

Перечислите все функции текущего приложения. Это поможет вам визуализировать доступные функции и их текущие конфигурации.

npx bucket features list [--app-id ap123456789]

Параметры:

  • --app-id : Идентификатор приложения для использования.
bucket features types

Генерируйте типы TypeScript для своих функций. Это обеспечивает безопасность типов при использовании функций Bucket в ваших приложениях TypeScript/JavaScript.

npx bucket features types [--app-id ap123456789] [--out gen/features.ts] [--format react]

Параметры:

  • --app-id : Идентификатор приложения для использования.
  • --out : Путь для генерации типов TypeScript.
  • --format : Формат сгенерированных типов (react или node).

bucket companies

Команды для управления компаниями.

bucket companies list

Перечислите все компании в вашем приложении.

npx bucket companies list [--filter <text>] [--app-id ap123456789]

Параметры:

  • --filter : Фильтрация компаний по названию или идентификатору.
  • --app-id : Идентификатор приложения для использования.

Команда выводит таблицу со следующими столбцами:

  • id : идентификатор компании.
  • name : Название компании (если не указано, отображается «(без названия)»).
  • users : Количество пользователей в компании.
  • lastSeen : дата последней активности компании.

bucket companies features access

Предоставьте или отмените доступ к определенным функциям для компаний, сегментов и пользователей. Если ключ функции не указан, вам будет предложено выбрать его из списка.

npx bucket companies features access [--app-id ap123456789] [featureKey] [--enable|--disable] [--companies <id...>] [--segments <id...>] [--users <id...>]

Аргументы:

  • featureKey : ключ функции, к которой необходимо предоставить/отозвать доступ (необязательно, интерактивный выбор, если не указан).

Параметры:

  • --enable : включить функцию для указанных целей.
  • --disable : Отключить функцию для указанных целей.
  • --users : Идентификаторы пользователей для цели. Можно указать несколько раз.
  • --companies : ID компаний для нацеливания. Можно указать несколько раз.
  • --segments : Идентификаторы сегментов для нацеливания. Можно указывать несколько раз.
  • --app-id : Идентификатор приложения для использования.

Необходимо указать хотя бы одну цель (компании, сегменты или пользователи). Также необходимо указать либо --enable , либо --disable , но не оба.

Пример:

# Enable feature for multiple companies and users npx bucket companies features access my-feature --enable --companies comp_123 --companies comp_456 --users user_789

bucket apps

Команды для управления приложениями Bucket.

Глобальные возможности

Эти параметры можно использовать с любой командой:

  • --debug : включить режим отладки для подробного вывода.
  • --base-url <url> : Установить базовый URL для API Bucket.
  • --api-url <url> : задать URL-адрес API напрямую (переопределяет базовый URL-адрес).
  • --help : Отображение справочной информации по команде.

Разработка с использованием ИИ

Bucket предоставляет мощные возможности разработки с помощью ИИ через правила и протокол контекста модели (MCP). Эти функции помогают вашим инструментам разработки ИИ лучше понимать ваши функции и предоставлять более точную помощь.

Правила корзины (рекомендуется)

Команда rules помогает вам настроить специфические правила AI для вашего проекта. Эти правила позволяют инструментам AI лучше понимать, как работать с флагами Bucket и feature и как их следует использовать в вашей кодовой базе.

npx bucket rules [--format <cursor|copilot>] [--yes]

Параметры:

  • --format : Формат для добавления правил:
    • cursor : добавляет правила в .cursor/rules/bucket.mdc для интеграции Cursor IDE.
    • copilot : добавляет правила в .github/copilot-instructions.md для интеграции GitHub Copilot.
  • --yes : Пропустить запросы на подтверждение и перезаписать существующие файлы без запроса.

Эта команда добавит правила в ваш проект, которые предоставляют инструментам ИИ контекст о том, как настраивать и использовать флаги функций Bucket. Для формата copilot правила будут добавлены в специальный раздел в файле, что позволит вам поддерживать другие инструкции copilot наряду с правилами Bucket.

Модель контекстного протокола

Model Context Protocol (MCP) — это открытый протокол, который обеспечивает стандартизированный способ подключения моделей ИИ к различным источникам данных и инструментам. В контексте Bucket MCP позволяет вашему редактору кода понимать ваши флаги функций, их состояния и их связи в вашей кодовой базе. Это создает бесшовный мост между вашим рабочим процессом управления функциями и инструментами разработки на основе ИИ. Сервер MCP размещен на Bucket, поэтому начать работу очень просто.

**Примечание: команда Bucket mcp CLI ранее использовалась для локального сервера. Однако в последних версиях Bucket CLI команда mcp была перепрофилирована, чтобы помочь вам подключиться к новому удаленному серверу MCP.**_

Настройка МКП

Команда mcp помогает вам настроить редактор или клиент AI для подключения к удаленному серверу MCP Bucket. Это позволяет вашим инструментам AI понимать ваши флаги функций и предоставлять более контекстную помощь.

npx bucket mcp [--app-id <id>] [--editor <editor>] [--scope <local|global>]

Параметры:

Команда проведет вас через:

  1. Выбор редактора/клиента для настройки.
  2. Выбор приложения Bucket для подключения.
  3. Выбор между глобальной или локальной конфигурацией проекта.
  4. Настройка соответствующего файла конфигурации для выбранного вами редактора.

Примечание: настройка использует mcp-remote в качестве уровня совместимости, что позволяет удаленному размещенному серверу Bucket MCP работать со всеми редакторами/клиентами, которые поддерживают серверы MCP STDIO. Если ваш редактор/клиент поддерживает HTTP Streaming с OAuth, вы можете подключиться к серверу Bucket MCP напрямую.

Разработка

# Build the CLI yarn build # Run the CLI locally yarn bucket [command] # Lint and format code yarn lint yarn format

Требования

  • Node.js >=18.0.0

Лицензия

Лицензия MIT Авторские права (c) 2025 Bucket ApS

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Отмечайте функции прямо из чата в редакторе кода, включая VS Code, Cursor, Windsurf, Claude Code — любую IDE с поддержкой MCP.

  1. Использование
    1. Индивидуальные команды
  2. Конфигурация
    1. Структура файла конфигурации
  3. Команды
    1. bucket init
    2. bucket new [featureName]
    3. bucket login
    4. bucket logout
    5. bucket features
    6. bucket companies
    7. bucket companies features access
    8. bucket apps
  4. Глобальные возможности
    1. Разработка с использованием ИИ
      1. Правила корзины (рекомендуется)
    2. Модель контекстного протокола
      1. Настройка МКП
    3. Разработка
      1. Требования
        1. Лицензия

          Related MCP Servers

          • A
            security
            A
            license
            A
            quality
            A template for creating custom tools for Cursor IDE using Model Context Protocol (MCP), allowing developers to extend Cursor's functionality with their own server-based tools.
            Last updated -
            11
            2
            Python
            MIT License
            • Apple
            • Linux
          • -
            security
            A
            license
            -
            quality
            SeekChat supports MCP tool execution, enabling AI to directly control your computer and perform various tasks. Easily automate file management, data analysis, code development, and more, turning AI into a truly intelligent assistant.
            Last updated -
            18
            JavaScript
            Apache 2.0
            • Apple
            • Linux
          • -
            security
            F
            license
            -
            quality
            An MCP server that allows AI assistants to programmatically manage Unleash feature flags through natural language, enabling operations like creating, updating, and retrieving feature flags across projects.
            Last updated -
            5
            2
            TypeScript

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/bucketco/bucket-javascript-sdk'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server