OpenFGA MCP

OpenFGA MCP-Server

Ein experimenteller Model Context Protocol (MCP)-Server, der Large Language Models (LLMs) das Lesen, Durchsuchen und Bearbeiten von OpenFGA- Speichern ermöglicht. Schaltet die Autorisierung für agentenbasierte KI und feinkörniges Vibe-Coding ✨ für Menschen frei.

Anforderungen

Python 3.12+
Ein OpenFGA-Server

Merkmale

Werkzeuge

Filialleitung

create_store : Erstellt einen neuen Store. ( create-store )
list_stores : Listet alle Geschäfte auf. ( list-stores )
get_store : Holen Sie sich die Geschäftsdetails. ( get-store )
delete_store : Löscht einen Store. ( delete-store )
get_store_id_by_name : Ruft die ID eines Geschäfts anhand seines Namens ab.

Autorisierungsmodellverwaltung

write_authorization_model : Schreiben Sie ein Autorisierungsmodell. ( write-authorization-model )
read_authorization_models : Listet alle Autorisierungsmodelle auf. ( read-authorization-models )
get_authorization_model : Ruft die Details einer bestimmten Version eines Autorisierungsmodells ab. ( get-authorization-model )

Verwaltung von Beziehungstupeln

write_relation_tuples : Schreibe Relationstupel. ( write-relation-tuples )
read_relation_tuples : Lies Relationstupel. ( read-relation-tuples )

Beziehungsabfragen

check : Überprüfen Sie, ob ein Benutzer eine Beziehung zu einem Objekt hat. ( prüfen )
list_objects : Listet Objekte eines Typs auf, zu dem ein Benutzer eine Beziehung hat. ( list-objects )
list_users : Listet Benutzer auf, die eine bestimmte Beziehung zu einem bestimmten Objekt haben. ( list-users )

Ressourcen

Eingabeaufforderungen

Verwendung

Wir empfehlen, den Server mit UVX auszuführen:

uvx openfga-mcp@latest

Installation über Smithery

So installieren Sie den OpenFGA MCP Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @evansims/openfga-mcp --client claude

Konfiguration

Der Server akzeptiert die folgenden Argumente:

--openfga_url : URL Ihres OpenFGA-Servers
--openfga_store : ID des OpenFGA-Speichers, den der MCP-Server verwenden wird
--openfga_model : ID des OpenFGA-Autorisierungsmodells, das der MCP-Server verwenden wird

Für die API-Token-Authentifizierung:

--openfga_token : API-Token zur Verwendung mit Ihrem OpenFGA-Server

Für die Client-Anmeldeinformationsauthentifizierung:

--openfga_client_id : Client-ID zur Verwendung mit Ihrem OpenFGA-Server
--openfga_client_secret : Client-Geheimnis zur Verwendung mit Ihrem OpenFGA-Server
--openfga_api_issuer : API-Aussteller zur Verwendung mit Ihrem OpenFGA-Server
--openfga_api_audience : API-Zielgruppe zur Verwendung mit Ihrem OpenFGA-Server

Zum Beispiel:

uvx openfga-mcp@latest \
  --openfga_url="http://127.0.0.1:8080" \
  --openfga_store="your-store-id" \
  --openfga_model="your-model-id"

Verwendung mit Claude Desktop

Um Claude für die Verwendung des Servers zu konfigurieren, fügen Sie Ihrer Claude-Konfiguration Folgendes hinzu:

{
  "mcpServers": {
    "openfga-mcp": {
      "command": "uvx",
      "args": ["openfga-mcp@latest"]
    }
  }
}

Möglicherweise müssen Sie den vollständigen Pfad zu Ihrer uvx ausführbaren Datei angeben. Verwenden Sie which uvx , um sie zu finden.
Sie müssen Claude nach der Aktualisierung der Konfiguration neu starten.

Verwendung mit Raycast

Verwendung mit Cursor

Verwendung mit Windsurf

Entwicklung

Führen Sie zum Einrichten Ihrer Entwicklungsumgebung Folgendes aus:

make setup

So führen Sie den Entwicklungsserver aus:

make run \
  --openfga_url="http://127.0.0.1:8080" \
  --openfga_store="your-store-id" \
  --openfga_model="your-model-id"

So führen Sie den Entwicklungsserver mit dem MCP Inspector aus:

make dev

Lizenz

Apache 2.0