Skip to main content
Glama

Bucket Feature Flags MCP Server

Official
by bucketco

Bucket-Befehlszeilenschnittstelle

Befehlszeilenschnittstelle für die Interaktion mit Bucket-Diensten. Mit der CLI können Sie Apps, Features und Authentifizierung verwalten und TypeScript-Typen für Ihre Bucket-Features generieren. Mit diesem Tool können Sie Ihren Feature-Flagging-Workflow direkt von Ihrem Terminal aus optimieren.

Verwendung

Beginnen Sie, indem Sie die CLI lokal in Ihrem Projekt installieren:

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

Führen Sie dann den new Befehl aus dem Stammverzeichnis Ihres Projekts aus, initialisieren Sie die CLI, erstellen Sie eine Funktion und generieren Sie die Typen auf einmal:

# npm npx bucket new # yarn yarn bucket new

Einzelne Befehle

Anstatt new auszuführen, können Sie jeden Schritt einzeln aufrufen.

# 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

Konfiguration

Die CLI erstellt die Datei bucket.config.json in Ihrem Projektverzeichnis, wenn Sie bucket init ausführen. Diese Datei enthält alle erforderlichen Einstellungen für Ihre Bucket-Integration.

Struktur der Konfigurationsdatei

Hier ist eine umfassende Liste der in der Datei bucket.config.json verfügbaren Konfigurationsoptionen:

{ "$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" } ] }
OptionBeschreibungStandard
$schemaAutovervollständigung für die Konfiguration. latest kann durch eine bestimmte Version ersetzt werden." https://unpkg.com/@bucketco/cli@latest/schema.json "
baseUrlBasis-URL für Bucket-Dienste." https://app.bucket.co "
apiUrlAPI-URL für Bucket-Dienste (überschreibt baseUrl für API-Aufrufe)." https://app.bucket.co/api "
appIdIhre Bucket-Anwendungs-ID.Erforderlich
typesOutputPfad(e), in dem/denen TypeScript-Typen generiert werden. Kann ein String oder ein Array von Objekten mit path und format sein. Verfügbare Formate: react und node .„gen/features.ts“ mit dem Format „react“

Sie können diese Einstellungen mithilfe von Befehlszeilenoptionen für einzelne Befehle überschreiben.

Befehle

bucket init

Initialisieren Sie eine neue Bucket-Konfiguration in Ihrem Projekt. Dadurch wird eine Datei bucket.config.json mit Ihren Einstellungen erstellt und Sie werden aufgefordert, alle erforderlichen Informationen einzugeben, die nicht über Optionen bereitgestellt werden.

npx bucket init [--overwrite]

Optionen:

  • --overwrite : Vorhandene Konfigurationsdatei überschreiben, falls vorhanden.
  • --app-id <id> : Legen Sie die Anwendungs-ID fest.
  • --key-format <format> : Legen Sie das Schlüsselformat für Features fest.

bucket new [featureName]

All-in-One-Befehl für den schnellen Einstieg. Dieser Befehl kombiniert init , Feature-Erstellung und Typgenerierung in einem einzigen Schritt. So starten Sie Bucket am schnellsten.

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

Optionen:

  • --key : Spezifischer Schlüssel für die Funktion.
  • --app-id : Zu verwendende App-ID.
  • --key-format : Format für Funktionsschlüssel (benutzerdefiniert, Snake, Camel usw.).
  • --out : Pfad zum Generieren von TypeScript-Typen.
  • --format : Format der generierten Typen (React oder Node).

Wenn Sie mehr Kontrolle über jeden Schritt bevorzugen, können Sie stattdessen die einzelnen Befehle ( init , features create , features types ) verwenden.

bucket login

Melden Sie sich bei Ihrem Bucket-Konto an. Dadurch wird Ihre CLI für nachfolgende Vorgänge authentifiziert und die Anmeldeinformationen sicher gespeichert.

npx bucket login

bucket logout

Melden Sie sich von Ihrem Bucket-Konto ab und entfernen Sie die gespeicherten Anmeldeinformationen.

npx bucket logout

bucket features

Verwalten Sie Ihre Bucket-Funktionen mit den folgenden Unterbefehlen.

bucket features create [featureName]

Erstellen Sie eine neue Funktion in Ihrer Bucket-App. Der Befehl führt Sie mit interaktiven Eingabeaufforderungen durch den Prozess der Funktionserstellung, falls keine Optionen bereitgestellt werden.

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

Optionen:

  • --key : Spezifischer Schlüssel für die Funktion.
  • --app-id : Zu verwendende App-ID.
  • --key-format : Format für Funktionsschlüssel.
bucket features list

Listen Sie alle Funktionen der aktuellen App auf. So können Sie sich einen Überblick über die verfügbaren Funktionen und ihre aktuelle Konfiguration verschaffen.

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

Optionen:

  • --app-id : Zu verwendende App-ID.
bucket features types

Generieren Sie TypeScript-Typen für Ihre Features. Dies gewährleistet die Typsicherheit bei der Verwendung von Bucket-Features in Ihren TypeScript-/JavaScript-Anwendungen.

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

Optionen:

  • --app-id : Zu verwendende App-ID.
  • --out : Pfad zum Generieren von TypeScript-Typen.
  • --format : Format der generierten Typen (React oder Node).

bucket companies

Befehle zur Verwaltung von Unternehmen.

bucket companies list

Listen Sie alle Unternehmen in Ihrer App auf.

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

Optionen:

  • --filter : Filtern Sie Unternehmen nach Name oder ID.
  • --app-id : Zu verwendende App-ID.

Der Befehl gibt eine Tabelle mit den folgenden Spalten aus:

  • id : Firmen-ID.
  • name : Firmenname (wird „(unbenannt)“ angezeigt, wenn nicht festgelegt).
  • users : Anzahl der Benutzer im Unternehmen.
  • lastSeen : Datum, an dem das Unternehmen zuletzt aktiv war.

bucket companies features access

Gewähren oder entziehen Sie Unternehmen, Segmenten und Benutzern den Zugriff auf bestimmte Funktionen. Wenn kein Funktionsschlüssel angegeben ist, werden Sie aufgefordert, einen aus einer Liste auszuwählen.

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

Argumente:

  • featureKey : Schlüssel der Funktion, für die der Zugriff gewährt/entzogen werden soll (optional, interaktive Auswahl, falls weggelassen).

Optionen:

  • --enable : Aktivieren Sie die Funktion für die angegebenen Ziele.
  • --disable : Deaktiviert die Funktion für die angegebenen Ziele.
  • --users : Zielbenutzer-IDs. Kann mehrfach angegeben werden.
  • --companies : Zielfirmen-IDs. Kann mehrfach angegeben werden.
  • --segments : Zielsegment-IDs. Kann mehrfach angegeben werden.
  • --app-id : Zu verwendende App-ID.

Mindestens ein Ziel (Unternehmen, Segmente oder Benutzer) muss angegeben werden. Sie müssen außerdem entweder --enable oder --disable angeben, aber nicht beides.

Beispiel:

# 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

Befehle zum Verwalten von Bucket-Apps.

Globale Optionen

Diese Optionen können mit jedem Befehl verwendet werden:

  • --debug : Aktiviert den Debug-Modus für ausführliche Ausgabe.
  • --base-url <url> : Legen Sie die Basis-URL für die Bucket-API fest.
  • --api-url <url> : Legen Sie die API-URL direkt fest (überschreibt die Basis-URL).
  • --help : Hilfeinformationen für einen Befehl anzeigen.

KI-gestützte Entwicklung

Bucket bietet leistungsstarke KI-gestützte Entwicklungsfunktionen durch Regeln und Model Context Protocol (MCP). Diese Funktionen helfen Ihren KI-Entwicklungstools, Ihre Funktionen besser zu verstehen und präzisere Unterstützung zu bieten.

Bucket-Regeln (empfohlen)

Mit dem Befehl rules können Sie KI-spezifische Regeln für Ihr Projekt einrichten. Diese Regeln ermöglichen es KI-Tools, die Arbeit mit Buckets und Feature-Flags und deren Verwendung in Ihrer Codebasis besser zu verstehen.

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

Optionen:

  • --format : Format zum Hinzufügen von Regeln:
    • cursor : Fügt Regeln zu .cursor/rules/bucket.mdc für die Cursor-IDE-Integration hinzu.
    • copilot : Fügt Regeln zu .github/copilot-instructions.md für die GitHub Copilot-Integration hinzu.
  • --yes : Bestätigungsaufforderungen überspringen und vorhandene Dateien ohne Nachfrage überschreiben.

Dieser Befehl fügt Ihrem Projekt Regeln hinzu, die KI-Tools Kontextinformationen zur Einrichtung und Verwendung von Bucket-Feature-Flags liefern. Für das Copilot-Format werden die Regeln einem eigenen Abschnitt in der Datei hinzugefügt, sodass Sie neben den Bucket-Regeln auch andere Copilot-Anweisungen verwalten können.

Modellkontextprotokoll

Das Model Context Protocol (MCP) ist ein offenes Protokoll, das eine standardisierte Möglichkeit bietet, KI-Modelle mit verschiedenen Datenquellen und Tools zu verbinden. Im Kontext von Bucket ermöglicht MCP Ihrem Code-Editor, Ihre Feature-Flags, deren Zustände und deren Beziehungen innerhalb Ihrer Codebasis zu verstehen. Dies schafft eine nahtlose Verbindung zwischen Ihrem Feature-Management-Workflow und KI-gestützten Entwicklungstools. Der MCP-Server wird von Bucket gehostet, sodass der Einstieg ganz einfach ist.

**Hinweis: Der Bucket-Befehl mcp wurde zuvor für einen lokalen Server verwendet . In neueren Versionen der Bucket-CLI wurde der Befehl mcp jedoch umfunktioniert, um Ihnen die Verbindung zum neuen Remote-MCP-Server zu erleichtern.**_

Einrichten von MCP

Mit dem Befehl mcp konfigurieren Sie Ihren Editor oder KI-Client für die Verbindung mit dem Remote-MCP-Server von Bucket. Dadurch können Ihre KI-Tools Ihre Feature-Flags verstehen und kontextbezogenere Unterstützung bieten.

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

Optionen:

  • --app-id : Für die MCP-Verbindung zu verwendende App-ID.
  • --editor : Der zu konfigurierende Editor/Client:
  • --scope : Ob die Einstellungen für das Projekt global oder lokal konfiguriert werden sollen.

Der Befehl führt Sie durch:

  1. Auswählen, welcher Editor/Client konfiguriert werden soll.
  2. Auswählen, mit welcher Bucket-App eine Verbindung hergestellt werden soll.
  3. Entscheidung zwischen globaler oder projektlokaler Konfiguration.
  4. Einrichten der entsprechenden Konfigurationsdatei für Ihren gewählten Editor.

Hinweis: Das Setup verwendet mcp-remote als Kompatibilitätsebene, sodass der remote gehostete Bucket MCP-Server mit allen Editoren/Clients funktioniert, die MCP-STDIO-Server unterstützen. Wenn Ihr Editor/Client HTTP-Streaming mit OAuth unterstützt, können Sie sich direkt mit dem Bucket MCP-Server verbinden.

Entwicklung

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

Anforderungen

  • Node.js >=18.0.0

Lizenz

MIT-Lizenz Copyright (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.

Markieren Sie Funktionen direkt aus dem Chat in Ihrem Code-Editor, einschließlich VS Code, Cursor, Windsurf, Claude Code – jede IDE mit MCP-Unterstützung.

  1. Verwendung
    1. Einzelne Befehle
  2. Konfiguration
    1. Struktur der Konfigurationsdatei
  3. Befehle
    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. Globale Optionen
    1. KI-gestützte Entwicklung
      1. Bucket-Regeln (empfohlen)
    2. Modellkontextprotokoll
      1. Einrichten von MCP
    3. Entwicklung
      1. Anforderungen
        1. Lizenz

          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