Skip to main content
Glama
Sign In
deenesjakoruzh

Bucket Feature Flags MCP Server

Official
by bucketco
npmGitHub
TypeScript
MIT License
2,225
10
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides integration with Node.js applications, allowing feature flag management and TypeScript type generation for Node.js projects

  • Provides CLI commands that can be executed via npm, supporting installation and execution of Bucket features

  • Offers feature flag management specifically tailored for React applications, including TypeScript type generation with React-specific formats

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" [--key my-feature] [--app-id ap123456789] [--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" [--key my-feature] [--app-id ap123456789] [--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 [featureKey] [--enable|--disable] [--companies <id...>] [--segments <id...>] [--users <id...>] [--app-id ap123456789]

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 Ihrer Entwicklungsumgebung, 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. MCP befindet sich in einem sehr frühen Entwicklungsstadium und wird häufig geändert. Sollte etwas nicht funktionieren, besuchen Sie bitte die Model Context Protocol-Website und eröffnen Sie hier ein Ticket .

Einrichten von MCP

MCP-Server laufen derzeit lokal auf Ihrem Rechner. Um den MCP-Server zu starten, führen Sie den CLI-Befehl aus Ihrem Bucket-initialisierten Projektverzeichnis aus:

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

Optionen:

  • --port : Port, auf dem der SSE-Server ausgeführt wird (Standard ist 8050, „auto“ für zufälligen Port).
  • --app-id : Zu verwendende App-ID.

Dadurch wird standardmäßig ein SSE-Server unter http://localhost:8050/sse gestartet, mit dem Sie sich mit dem Client Ihrer Wahl verbinden können. Nachfolgend finden Sie Beispiele, die für Cursor IDE und Claude Desktop funktionieren.

Serverseitige Ereignisse (SSE)
{ "mcpServers": { "Bucket": { "url": "http://localhost:8050/sse" } } }
STDIO-Proxy

Einige Clients unterstützen SSE nicht und können stattdessen über einen STDIO-Proxy mit dem MCP-Server kommunizieren.

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

Cursor-IDE

So aktivieren Sie MCP-Funktionen in Cursor IDE :

  1. Öffnen Sie die Cursor-IDE.
  2. Gehen Sie zu Settings > MCP .
  3. Klicken Sie auf Add new global MCP server und fügen Sie die SSE -Konfiguration ein.
  4. Speichern und zurück zum Cursor.

Claude Desktop

So aktivieren Sie MCP-Funktionen in Claude Desktop :

  1. Öffnen Sie Claude Desktop.
  2. Gehen Sie zu Settings > Developer .
  3. Klicken Sie auf Edit config und fügen Sie die STDIO -Konfiguration ein.
  4. Speichern und Claude Desktop neu starten.

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

This server cannot be installed

-
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
      2. Cursor-IDE
      3. Claude Desktop
    3. Entwicklung
      1. Anforderungen
        1. Lizenz

          Related MCP Servers

          • language-server-mcp

            alexwohletz
            A
            security
            A
            license
            A
            quality
            TypeScript-based MCP server designed to enhance code editing experiences by providing features such as hover information, code completion, and diagnostics.
            Last updated -
            3
            13
            MIT License
            • Apple

          • Bifrost VSCode Devtools

            biegehydra
            -
            security
            A
            license
            -
            quality
            A VS Code extension provides a MCP server that exposes Roslyn language features. It enables tools like find usages, go to definition, quick info, etc.
            Last updated -
            81
            TypeScript
            AGPL 3.0
            • Linux
            • Apple

          • DevEnvInfoServer

            carterlasalle
            -
            security
            F
            license
            -
            quality
            An MCP server that provides detailed information about your development environment to the Cursor code editor, enabling more context-aware assistance.
            Last updated -
            1
            Python
            • Linux
            • Apple

          • Unleash Feature Flag MCP Server

            ylin6
            -
            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

          New MCP Servers

          ID: h3p2ndqmat