OpenFGA MCP

by evansims
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Supports containerized deployment using Docker for running the OpenFGA MCP server in isolated environments

  • Allows installation from GitHub source repository as an alternative to package managers

  • Built using the OpenFGA Python SDK and MCP Python SDK, requiring Python 3.10+ for operation

Servidor MCP OpenFGA

Un servidor experimental de Protocolo de Contexto de Modelo (MCP) que permite a los Modelos de Lenguaje Grandes (LLM) leer, buscar y manipular almacenes OpenFGA . Facilita la autorización para IA con agentes y la codificación de vibraciones de grano fino ✨ para humanos.

Requisitos

Características

Herramientas

Gestión de tiendas

  • create_store : Crea una nueva tienda. ( create-store )
  • list_stores : Lista todas las tiendas. ( list-stores )
  • get_store : Obtener los detalles de una tienda. ( get-store )
  • delete_store : Eliminar una tienda. ( delete-store )
  • get_store_id_by_name : obtiene el ID de una tienda por su nombre.

Gestión del modelo de autorización

Gestión de tuplas de relaciones

Consultas de relación

  • check : Comprueba si un usuario tiene una relación con un objeto. ( comprobar )
  • list_objects : enumera objetos de un tipo con el que un usuario tiene una relación. ( list-objects )
  • list_users : enumera los usuarios que tienen una relación determinada con un objeto determinado. ( list-users )

Recursos

Indicaciones

Uso

Recomendamos ejecutar el servidor utilizando UVX :

uvx openfga-mcp@latest

Instalación mediante herrería

Para instalar OpenFGA MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Configuración

El servidor acepta los siguientes argumentos:

  • --openfga_url : URL de su servidor OpenFGA
  • --openfga_store : ID del almacén OpenFGA que utilizará el servidor MCP
  • --openfga_model : ID del modelo de autorización OpenFGA que utilizará el servidor MCP

Para la autenticación del token API:

  • --openfga_token : token de API para usar con su servidor OpenFGA

Para la autenticación de credenciales de cliente:

  • --openfga_client_id : ID de cliente para usar con su servidor OpenFGA
  • --openfga_client_secret : Secreto de cliente para usar con su servidor OpenFGA
  • --openfga_api_issuer : emisor de API para usar con su servidor OpenFGA
  • --openfga_api_audience : audiencia de API para usar con su servidor OpenFGA

Por ejemplo:

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

Uso con Claude Desktop

Para configurar a Claude para que use el servidor, agregue lo siguiente a su configuración de Claude:

{ "mcpServers": { "openfga-mcp": { "command": "uvx", "args": ["openfga-mcp@latest"] } } }
  • Quizás necesite especificar la ruta completa del ejecutable uvx . Use which uvx para encontrarlo.
  • Debes reiniciar Claude después de actualizar la configuración.

Uso con Raycast

Uso con cursor

Uso con Windsurf

Desarrollo

Para configurar su entorno de desarrollo, ejecute:

make setup

Para ejecutar el servidor de desarrollo:

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

Para ejecutar el servidor de desarrollo con el Inspector MCP:

make dev

Licencia

Apache 2.0

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

Un servidor de protocolo de contexto de modelo experimental que permite que los modelos de lenguaje grandes lean, busquen y manipulen almacenes de autorización OpenFGA, desbloqueando un control de acceso de grano fino para la IA agencial y las interacciones de lenguaje natural.

  1. Requirements
    1. Features
      1. Tools
      2. Resources
      3. Prompts
    2. Usage
      1. Installing via Smithery
      2. Configuration
      3. Using with Claude Desktop
      4. Using with Raycast
      5. Using with Cursor
      6. Using with Windsurf
    3. Development
      1. License
        ID: 5n8r5l5ir3