Флаги функций ведра MCP-сервер

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 "
`apiUrl`	URL-адрес 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" [--key my-feature] [--app-id ap123456789] [--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" [--key my-feature] [--app-id ap123456789] [--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 [featureKey] [--enable|--disable] [--companies <id...>] [--segments <id...>] [--users <id...>] [--app-id ap123456789]

Аргументы:

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 находится на очень ранней стадии разработки, и изменения в него вносятся часто. Если что-то не работает, посетите веб-сайт Model Context Protocol и откройте тикет здесь .

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

MCP-серверы в настоящее время работают локально на вашей машине. Чтобы запустить MCP-сервер, выполните команду CLI из вашего каталога проекта, инициализированного Bucket:

npx bucket mcp [--port <number|"auto">] [--app-id ap123456789]

Параметры:

--port : Порт для запуска сервера SSE (по умолчанию 8050, «auto» для случайного порта).
--app-id : Идентификатор приложения для использования.

Это запустит сервер SSE по адресу http://localhost:8050/sse по умолчанию, к которому вы можете подключиться с помощью выбранного вами клиента . Ниже приведены примеры, которые работают для Cursor IDE и Claude Desktop .

События на стороне сервера (SSE)

{
  "mcpServers": {
    "Bucket": {
      "url": "http://localhost:8050/sse"
    }
  }
}

STDIO-прокси

Некоторые клиенты не поддерживают SSE и вместо этого могут взаимодействовать с сервером MCP через прокси-сервер STDIO.

{
  "mcpServers": {
    "Bucket": {
      "command": "npx",
      "args": ["-y", "supergateway", "--sse", "http://localhost:8050/sse"]
    }
  }
}

Курсор IDE

Чтобы включить функции MCP в Cursor IDE :

Откройте среду разработки курсора.
Перейдите в Settings > MCP .
Нажмите Add new global MCP server и вставьте конфигурацию SSE .
Сохраните и вернитесь к курсору.

Клод Десктоп

Чтобы включить функции MCP в Claude Desktop :

Откройте рабочий стол Клода.
Перейдите в Settings > Developer .
Нажмите Edit config и вставьте конфигурацию STDIO .
Сохраните и перезапустите Claude Desktop.

Разработка

# 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

Bucket Feature Flags MCP Server

Integrations

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

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

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

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

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

Команды

`bucket init`

`bucket new [featureName]`

`bucket logout`

`bucket features`

`bucket features create [featureName]`

`bucket features list`

`bucket features types`

`bucket companies`

`bucket companies list`

`bucket companies features access`

`bucket apps`

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

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

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

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

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

События на стороне сервера (SSE)

STDIO-прокси

Курсор IDE

Клод Десктоп

Разработка

Требования

Лицензия

Related MCP Servers

language-server-mcp

Bifrost VSCode Devtools

DevEnvInfoServer

Unleash Feature Flag MCP Server

New MCP Servers